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PREFACE 



This is a complete reference manual for the SOS text editor, a TOPS-10 
utility program. It is written for the beginner who is familiar with 
other text editors, as well as for the experienced SOS user needing 
reference material for the SOS program. 

This manual assumes the computer you use has a TOPS-10 monitor and you 
know how to log in. It also assumes that you have read the following 
manual : 

SOS User's Guide (DEC-10-USOSA-A-D) 

Copies of this manual can be purchased through DIGITAL'S Software 
Distribution Center. 

If you find any errors in this manual, please fill out and mail the 
Reader's Comment Card found at the back of this manual. All reported 
errors in the documentation of this manual will be corrected as soon 
as possible. Updates to this manual can be purchased separately and 
can be obtained from the Software Distribution Center. 

Chapter 1, Introduction To The SOS Program, can be used as a review 
for all SOS users. 

Chapter 4, Using SOS Options, and Chapter 5, SOS Command Descriptions, 
are printed on blue paper for ease in reference. 

Examples in this manual use files containing text and programs. Some 
of the examples show how to correct spelling and punctuation errors. 
Because you need not be familiar with any programming languages, the 
word "filespec" is used to refer to the full file specifications that 
can be used in SOS. 

The TOPS-10 SOS Reference Card is a pocket guide listing all SOS 
commands, options, special features, and error messages. One 
reference card is included in the packaging of this manual. 



Symbols Used In This Manual 



Symbol 


Meaning 


*P500:700 


Anything you type on your terminal appears in 
red. Anything the system prints on your terminal 
appears in black. 


C RET ) 


Press the key labeled RETURN or CR. 


( DEL ) 


Press the key labeled DELETE or RUBOUT. 


C ESC ) 


Press the key labeled ESC, ESCAPE, ALT, or PRE. 


( LF 3 


Press the key labeled LINEFEED or LP. 


C sr ) 


Press the space bar once. 


( BS ) 


Press the key labeled BACKSPACE. 


( TAB ) 


Press the key labeled TAB or press the keys 
labeled CTRL and I together. 


[] 


Brackets enclose all optional arguments. 





Parentheses enclose the name or value of an 
argument. 
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CHAPTER 1 
INTRODUCTION TO THE SOS PROGRAM 



This chapter describes the various formats of the SOS and R SOS 
commands that start the SOS program. This chapter also describes the 
control modes and the commands that allow you to exit from SOS. 

Before you can start SOS, you must log in to the TOPS-10 system. Give 
either the SOS or the R SOS command to create or edit a file. 

NOTE 

The SOS command is used in all the 
descriptions and examples throughout 
this manual. See Section 1.8 for a 
description of the R SOS command. 



1.1 CREATING A FILE 

When you issue the SOS command, SOS responds with a word called a 
keyword. The keyword may be either FILE: or INPUT:, depending on 
whether you had named the file or not. 

To create a new file, select a file specification that does not 
already exist and give it either as an argument to the SOS command or 
as an argument to the SOS keyword FILE:. For example, 



♦ SOS FACTOR ♦HACr^iQ 

input: factor ♦mac 

00100 



or 



♦ SQS C RtT ) 

file: factor ♦ mac GiD 

input: factor ♦MAC 
00100 

In the first example, you type SOS and the new file specification, 
press RETURN, and SOS will print INPUT:. In the second example, you 
type SOS and press RETURN, and SOS will print FILE:. In either case, 
you type the file specification as an argument, then press RETURN. 
SOS creates that new file, prints INPUT: followed by the file 
specification, and prints the default line number 00100. Now you can 
start entering the contents of your file. 
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INTRODUCTION TO THE SOS PROGRAM 

The default line number 00100 can be changed with the START option. 
Each time you press RETURN (carriage return) , SOS gives a new line and 
line number. 

The filename may be from one to six alphanumeric characters (A through 
Z and through 9) . No special characters are allowed. If you use 
any character other than A through Z or through 9, SOS will respond 
with the error message: ? ILLEGAL CHAR IN CMD and will then prompt 
you with the keyword FILE:. You must then specify new file 
specification or press Control C (CTRL/C) to return to the TOPS-10 
monitor. If you specify more than six characters as a filename, SOS 
will recognize only the first six characters. For example, 

CZD 

\ , ^ 

»sos a%bcd»xxxc«d 

? illtlgal char in cmd 
file: -^c 

t 



CE3 

\ ^ ^ 

♦ sos abcdef-'gh uk* xxx c^tt) 

input: abcdef*xxx 

00100 

The period character (.) is the only character that can be used as the 
separator between the filename and the file extension. 

The file extension may be from one to three alphanumeric characters (A 
through Z and through 9) . No special characters are allowed. If 
you specify more than three characters, SOS will recognize only the 
first three characters. The file extension may be omitted. For 
example, 

I 

♦ SOS ABCD. !2*4CRiD 

? ILLEGAL CHAR IN CMD 
file: ABCtU 123456789 CrID 

input: abcd.i2;5 

00100 



NOTE 

If you want your file to contain a 
program, use one of the standard 
extensions as your file extension. 
Refer to Appendix D, TOPS-10 Standard 
File Extensions, for a complete list of 
system file extensions. 
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INTRODUCTION TO THE SOS PROGRAM 

If you have read/write privileges to another directory, you may 
specify a device before the filename and extension and a path 
specification and protection code after the filename and extension. 
This is referred to as a full file specification. For example. 



i ^ ^ 

♦ SOS DSKC : SAMF'LE . TXT C 27 v 1 3'o J<0rj5.> (JtT) 

INPUT : DSKC : SAMPLE ♦ TXT 1:27 y 1351 
00100 

(Refer to Section 1.6 for additional information on editing files in 
another directory. Refer to Chapter 2, Giving Commands, for a 
complete description of full file specifications.) 

If you already have a file in your directory with the filename and 
file extension that you specified in the SOS command, SOS prints EDIT: 
and your file specification. (You are now in Edit mode and not in 
Input mode.) If you do not want to edit the current file, give the EQ 
command to exit from the SOS session, and then respecify the SOS 
command with a new file specification. For example. 



vSOS SAMPLE.TXT QE) 
edit: SAMPLE .TXT 

*Ea QhD 

»SOS ( RET ) 

I-" 1 1... E : SAM F ' L E ♦ D A T dlD 

input: sample.dat 

00100 

SOS will not let you inadvertently destroy your file when you start 
SOS at TOPS-10 command level. 

After you give the SOS command and your new file specification, you 
may enter the contents of your file. If you make typing errors, press 
DELETE to delete one character at a time or press BACKSPACE to move 
the cursor (of a display terminal) backward one character at a time. 
These editing characters operate only on the current line. After you 
press RETURN, you must give other SOS commands to change the contents 
of the line. (Refer to Section 2.3, Correcting Typing Errors, for 
more information and examples.) 

When you finish entering the contents of your file, press ESCape. SOS 
will then print an asterisk (*) , which indicates that SOS is at 
command level in Edit mode. To end the SOS session and save the file, 
type E and oress RETURN. For example. 



.SOS Lli 

input: 

00100 
00200 
00300 


•TTER.TXT ( RET ) 
LETTER* TXT 
THIS IS LINE 
THIS IS LINE 
* 

t 

( E«) 


100 OF 
200 OF 


LETTER.TXT 
LETTER.TXT 









CED 



[;dskc : letter * txti:27 » 5107 1:\ 
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INTRODUCTION TO THE SOS PROGRAM 

Remember, after you press ESCape, SOS prints an asterisk (*) . You can 
then give any sequence of SOS commands that helps prepare your file. 

Each file you create is kept in your default directory path unless you 
specify a different path following the filnam.ext for another 
directory where you have read/write privileges. 



1.2 ENDING SOS 

Give the End command to end SOS and save your file. Give the Go 

command to end SOS, save your file, and execute the last COMPILE, 

EXECUTE, LOAD, or DEBUG command that was given at TOPS-10 command 
level . 

When you give a command that saves your file (End, Go or World), SOS 
creates a backup file as well, by assigning your previous file the 
same name but a file extension beginning with a Q. This happens 
because the BAK option is turned on when you start SOS. To alter this 
default, set the /NOBAK option. If you specify the NOBAK option in an 
SOS session, SOS does not rename your previous file. (Refer to 
Section 4.4.16 for a description of the NOBAK option.) The World 
(Save-the-World) command saves your file as described, but does not 
end the SOS session. 

One of the following options can be used with the End command when you 
save your file: 

1. The B option suppresses the creation of the .Qxt and .Zxt 
backup file. The .Zxt file is only created when the /OLD 
option is set, i.e., the B option overrides the /OLD option. 

2. The D option suppresses the saving of your edited file and 
deletes your original file from your directory. 

3. The Q option suppresses the saving of your edited file and 
exits from SOS leaving your original file intact. 

4. The S option unsequences (removes the line numbers) from your 
edited file before saving it. 

If no option is specified with the E, G, or W command, your file is 
saved as it appears, including the line numbers. (Refer to Chapter 5 
for further descriptions and command formats of the E, G, and W 
commands and their options.) 



1.3 USING OPTIONS WITH SOS 

The SOS program includes various switches (referred to as options in 
this manual) that allow you to tailor the SOS program to your needs. 
Some of these options are automatically turned on (for example BAK, 
which backs up your file) . Other options are automatically turned off 
(for example LOWER, which allows lowercase character input) . In 
addition, other options contain a value (for example MAXLN, which 
specifies the maximum number of input lines per page for your file) . 
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By setting one or more options with the SOS command (or during an SOS 
session) , you can turn the options on or off and also change the 
options that contain a value. (Refer to Chapter 4, Using SOS Options, 
for a complete description of all the available SOS options and their 
uses. ) 

To set options, use a command of the following form: 

»S0S/START: 10/C:i28/EXPERTGr73 

file: text^rnqOTTO 
input: text^rng 

00010 

As the example above shows, you type SOS followed by a slash (Set 
option command) and the desired option. A slash character (/) must 
precede each option that you specify. You then press RETURN and SOS 
prints FILE: . Now you can type the file specification. Although 
spaces and tabs are allowed between options, they are not allowed in 
the file specification. 

When specifying SOS options with the SOS command, there are four 
formats you can use. They are: 



or 



♦ SOS ABCruTXT/C128/SEPARAT0RS/START:i0QiD 

input: ABCn.TXT 

00010 



♦ S0S/C128/SEPARATORS/SIART: 10 ABCD^TXTQID 

input: ABClUTXT 

00010 



or 



or 



file: / c 1 2 8 / s e: i-- a r a t o r s / s r a r r : i o a b c b * i x r (Jiy_) 
input: abcb»txt 

00010 



»sos QiD 

file: abcd*txt/c:128/separatgrs/start:;!.o 

input: ABCD/rXT 
00010 
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If you try to set a nonexistent option when you start SOS, the SOS 
program prints 7ILLEGAL SWITCH, followed by FILE: . You must then 
retype the file specification and the desired options. For example, 

♦ SOS SAMF'I...E»TXT/C128/SIH:PERAT0RSGiD 
? ILLEGAL SWITCH 

file: sample tTXT/C;L28/SEPARAiORSCI^ 

input: sample.txt 

00100 



1.4 SOS CONTROL MODES 

SOS has the following three basic control modes, which you can 
initiate through the SOS command level: 

1. Input (See Section 1.4.1.) 

2. Alter (See Section 1.4.2.) 

3. Edit (See Section 1.4.3.) 

Other modes can exist, such as BASIC, EXPERT, and READONLY, which you 
can initiate with any of the SOS options. (Refer to Chapter 4, Using 
SOS Options, for a complete description of these options.) 



1.4.1 Input Mode 

You can use Input mode to create a file. SOS indicates that you are 
in Input mode by printing a line number as a prompt. The SOS default 
line number is 00100 with increments of 100. To change this default, 
use the INCREMENT and START options described in Chapter 4. 

You can start Input mode in four ways: 

1. By creating a new file 

Type the input file specification for a new file. SOS 
automatically starts out in Input mode. For example. 



I 

*SGS COBOL. CBL C^TT) 

input: COBOL <.cbl 

J. ;i: n e n t ;i: i-- i c a i' j: o n b ;i: m i s :i: o n 

00200 PROGRAM ■IB.. SAMPLE Q^D 
3 A l..t T !■•! R ♦ B 1 G 1 T A L.. .. (^D 
00400 '^ 
t 



!;: n s k c; : c: g b g l ♦ c b i... i: 2 7 y ;:> :i. o / ::i j 



In this example, you type the contents of the line and then 
press RETURN. SOS then generates the next line number in 
Input mode. This mode continues until you press ESCape. 
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2. By editing a nonexistent file 

When you attempt to edit a file that does not exist, the SOS 
program creates the file and initiates Input mode. For 
example, 

I ^ ^ 

♦ SOS CABOI... >CBLO^rn 
inf-'Ut; cabgl .cbl 

00100 $ 

t 



>KE-CI GiD 



If you do not want to create this new file, press ESCape to 
end Input mode. When an asterisk appears, type EQ and press 
RETURN to end the SOS session without saving the file. 

By editing an existing file with the Insert command 

To edit an existing file, you may use the Insert command to 
enter Input mode. For example, 

I 

»SOS COBOL ♦CBL C^t ) 
edit: COBOL ♦CBL 

*i400C«ID 

00400 ENviIRONMENV DIVISION* QiD 
00500 DATE DIVISION ♦$ 

t 

SOS will continue in this mode if you are inserting lines at 
the end of your file or at the end of a page in your file. 
To return to Edit mode, press ESCape to end Input mode. 

By editing an existing file with the Replace command 

To edit an existing file, you may use the Replace command to 
enter Input mode. For example, 

i ^ ^ 

♦ SOS COBOL ♦CBL CEJD 

edit: COBOL ♦cbl 

)KR500 GiiJ) 

00500 CONF" I CURAT I ON SECT I ON ♦ CIlD 

00600 S Q U R C E - C M F' U I' E R ♦ D E C S Y S 7 E M - • 1 ♦ CZD 

00700 * 

1 LINES (00500/1) DELETED 
* 

SOS will continue in this mode if you are replacing lines at 
the end of your file or at the end of a page in your file. 
To return to Edit mode, press ESCape to end Input mode. 
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1.4.2 Alter Node 

When you are in Alter Mode, you can change or correct a file character 
by character. To enter Alter mode from the SOS command level, type A 
and a specific line number or range of line numbers. 

Alter mode contains its own instructions which do not echo on the 
terminal. When you use these Alter instructions, the content of the 
line being altered does echo on the terminal. See Chapter 5, SOS 
Command Descriptions, for a further description of the Alter command. 



In the following example you create a file, press 
enter Alter mode by typing A and a line number. 



ESCape, and then 



( SP ) 

1 

♦ SOS S( 












!^mple: » 1 


rXT' 


("") 






input: 


SAMPLE ♦TXT 






00100 


THIS 


IS 


PAGE 


TUOr LINE 


TWO ( «T ) 


00200 


THIS 


IS 


PAGE 


ONE» LINE 


TWO ( «" ) 


00300 


THIS 


IS 


PAGE 


ONE» LINE 


FOUR ( «T ) 


00400 


THIS 


IS 


PAGE 


TWOf LINE 


F- OUR ( «ET ) 


00500 


t 

( Ei ) 




















*A100( "ET ) 










00100 


THIS 


IS 


PAGE 


WTWOWONE 


if LINE TWC 




t 






t" 


\ 




3W 






3 CONE 


3W 


*P100( «ET ) 










00100 

* 


THIS 


IS 


PAGE 


ONE» LINE 


ONE 



rWOWTWOWONE 



t 



■3i:iiONE C^DdnD 



In the following example, you edit an existing file and enter Alter 
mode by typing A and a specific range of line numbers. 



(_p 



♦ SOS SAMPLE . TXT O^ 

edit: SAMPLE ♦TXT 

*A300:400Q^ 

00300 THIS IS PAGE ONE. LINE WFOURWTHREE 



00400 



t t t t t t i 

W WW www 4DITHREE Q£)CiD 

THIS IS PAGE TWOWTWOWONE' LINE FOUR 



t t t 

W WW 



t 

31.1 1 ONE GEDC^D 



*P30o:40o GhJ 

00300 THIS IS PAGE ONE» LINE THREE 
00400 THIS IS PAGE ONE. LINE FOUR 

*E CHID 

[: DSKC t SAMPLE* TXT L 27 y 51 07:3 ;j 
You can change from one mode to another during any SOS session, 
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1.4.3 Edit Mode 

You are in Edit mode when you change or edit an existing file on a 
line-by-line basis. You can also be in Edit mode after you create a 
file and before you end an SOS session. An asterisk (*) prompt 
character indicates that you are in Edit mode, 

.SOS COBOL tCBl. QID 

edit: COBOL. cbl 

*D400 C^jJ 

1 LINES (00400/1) DELETED 

^P 100 I '500 Q^ 

00100 IDENTIFICATION DIVISION* 

00200 PROGRAM ID. SAMPLE 

00300 AUTHOR* DIGITAL* THIS IS AN SOS EXAMPLE 

00500 DATA-DIVISION. 

* 

Once you are in Edit mode, you can type in any of the SOS 
program-level commands described in Chapter 5 and Appendix A, 



1,5 EDITING A FILE 

To correct (edit) an existing file, type the SOS command with the 
proper file specification and any options desired, (You can specify 
the options before the file specification or after it.) 

. s s sam i"' l e . t x t / c 1 2 8 / d e c i d e c^t) 
edit: sample.TXT 



or 



I. 



♦ S0S/C128/DECIDE 'SAMPLE . TXT GiD 
edit: SAMPLE.TXT 

When you start SOS to edit a file, SOS prints EDIT:, your file 
specification, and an asterisk which is the Edit mode prompt 
character , 

Every SOS command format shown in Section 1.1 allows you to specify a 

new file specification for an existing file by using the equal sign 

character (=) . In the example below, you can specify a new file, 
TEST. TXT, to be edited from the existing file, SAMPLE.TXT. 

.SOS TEST . TXT-SAMPLE . TXT QiD 
edit: sample* TXT 
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SOS options can be included either before or after the file 
specification. If you specify a file specification that does not 
exist, SOS prints INPUT: instead of EDIT:. 

I ^ ^ 

♦ SOS/EXPERT ABCD ♦ TXT -WXYZ ♦ TXT QeT) 

input; wxyz»txt 

00100 

The example above shows that when you specify the EXPERT option and a 
new file specification of ABCD. TXT for a WXYZ.TXT file specification 
that does not exist, SOS will create this file. To check that the 
ABCD. TXT file was created, use the NAME option of the Give (=) 
command; SOS will print the output file specification. For example, 

00100 * 
t 



*=-NAhE GID 
DSKCt ABCD ♦TXT 
Xf 

When you use the SOS format with the equal sign (=) character, SOS 
preserves the existing copy of your file and saves the changes in a 
file stored separately. 

To change your file, use any of the SOS commands listed in Chapter 5, 
SOS Command Descriptions, or Appendix A. When you have completed 
editing your file, give the E command to save your file. SOS then 
prints the name of the saved edited file. For example, 

i 

»SC)9 LIBARY ♦ TXT = -STAT ♦ TXT C^FT) 

edit; 8TAT.TXT 

»D200;300C1ID 

2 LINES (00200/1 ; 00300) DELETED 

*E CIeD 

r: DSKC t L I B AR Y . TXT [; 27 ? 5 1 071 1 

In the example above, STAT. TXT remains intact and LIBARY.TXT contains 
the results of the single SOS change. If you specify a file that does 
not exist, SOS will create that file as you have specified. If you do 
not want to create the file, press ESCape, and then give the EQ 
command . 
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1.6 EDITING A FILE IN ANOTHER DIRECTORY 

To edit a file that is in another directory, access that file with the 
SOS command, thus creating the edited file in your directory. This 
SOS command format is similiar to that used to rename the output file 
specification. (See Section 1.5, Editing A File.) 



. SOB rt:i:NH;; ♦ txt^^=^ yours . TXTf:27 . 235;jQ£D 

edit: yours ♦TXTi;;27y 235 j 
)J(-NAME QeT) 

DSKC t M I NE V TXT 127 r 51071 
*E QeT) 

[: DSKC tMJ:NE.TXT[:27y 1^107 J ;] 



In this example, you automatically create the file MINE. TXT in your 
directory from the file YOURS.TXT in the directory whose directory 
path is [27,235]. You can specify SOS options with this format and 
you can give any SOS commands to change the contents of the file 
MINE. TXT. 



NOTE 

An alternative procedure for editing a 
file located in another directory is to 
use the TOPS-10 monitor command COPY. 
This command places an image of the file 
in your directory path. After editing 
it there, you may copy it back into the 
original directory. 

If you have read/write privileges for another path (directory) , you 
can create or edit a file in place with SOS when you specify a full 
file specification. 



1.7 RECALLING ARGUMENTS TO THE SOS COMMAND 

When you type arguments (options and file specifications) to an SOS 
command and that command successfully starts SOS, the TOPS-10 monitor 
remembers those arguments. If you give a subsequent SOS command but 
do not give any arguments, the monitor supplies the arguments from 
your last SOS command. Thus you can create a file, run another 
program, and return to edit the file without retyping the arguments. 

In the following example, you create a file and then edit it. The 
second SOS command uses the arguments you typed in the first SOS 
command. 
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♦ S0S/C128/SEF'ARAT0RS/DECIDE/START i 10 SAMPLE ♦ TXTQiD 

input: sample ♦TXT 

00010 THIS IS LINE ONEr PAGE ONE,GlD 

00110 % 



J^ 



CDSKC: SAMPLE /rXT] 

fSOsGID 

edit: sample.txt 

* =CASE Q^ 

MODEL 37 SEPARATORS UPPER 

^--'^ de c i he o^tt) 
auto decide 
■*==startGED 

10 

* 

If you specify a file specification that is different from the 
previous SOS command, SOS tries to create the file you specified. At 
the same time, SOS uses the options from the previous SOS command. 
For example. 



♦S0S/C128/DECIDE/ST art: 10/ increment: 10 SAMPLE, TXT Qm; 

input: sample f TXT 

00010 THIS IS LINE ONE » PAOE ONE ,C^^ 

00020 * 



CDSKC: SAMPLE ♦TXT J 

♦ SOS TEXTOl ♦ TXT OTTT ) 
input: TEXTOl/rXT 
00010 * 



*:-NAME 

dskc:textoi,txt 

*=CASECEiD 
MODEL 37 UPPER 
*=DECIDECiD 
AUTO DECIDE 

»=iNc r^ro 

10 

A SWITCH.ini option file in your logged-in PPN (project-programmer 
number) allows you to automatically set the options you want for each 
SOS session. (Refer to Chapter 4, Using SOS Options, for more 
detailed information about the SWITCH.INI option file and how to use 
it.) 
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1.8 THE R SOS COMMAND 

The R SOS command starts an SOS session so that you can create and/or 
edit a file. The R command is equivalent to RUN SYStSOS.EXE at 
TOPS-10 monitor command level. You can use various formats of this 
command with SOS. For example, 

i , ^ 

» R SOS GID 

file: Ai:(CI.t.TXT/C128/SEPAFi;AT0RS/START:i0GID 

input: ABCruTXT 

00010 

or 



» R SOS (_«i 



or 



CiD 
file:: /ci28/separators/start: ;lo abciutxtQED 

input: ABCtUTXT 
00010 



♦R sos-abcd»txt/ci28/start:io Oil) 

input: ABCIUTXT 
00010 



or 

CjD CE3 

. R SOS -/C:i28/START ; 10 ABCD ♦ TXTQED 

input: ABCD ♦TXT 

00010 

As these examples show, you can specify the file specification either 
before or after the options when using the R SOS command. If your 
file specifications are for an existing file in your directory, the 
keyword INPUT: is substituted for the keyword EDIT:. 

As with the SOS command discussed in Section 1.5, you can use the 
equal sign (=) character to specify a new file specification when you 
give the R SOS command to create a new file in your directory. This 
form of the R SOS command renames your edited file. For example. 



R SOS 



file : sample . txt==letter ♦ txt ced 
edit: letter.TXT 

*=NAME QeD 
SAMPLE.TXT 
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1-1. 



CHAPTER 2 
GIVING COMMANDS 



To set your terminal's physical characteristics, use the TOPS-10 
command: SET TTY with arguments WIDTH, SPEED, PAGE, and so forth. 

There are four command formats you can use to enter SOS. Within SOS, 
there are two command levels. 



2.1 COMMAND FORMATS 

The formats you can use to enter SOS are: 
1. .SOS QeD 



FILE: output. ext=input,ext/switches ( ret ) 
2. .SOS GE) 



FILE: /switches output. ext=input.ext C "et ) 

3. .SOS/switches output. ext=input.ext ( ret ) 

4. .SOS output. ext=input.ext/switches ( ret ) 

SOS requires that input. ext represents a new file or an existing file. 

The /switches can be one or more settable options. If SOS encounters 
an illegal option (switch) , it ignores the all specified options and 
the file specification and prompts you with the word FILE:. You must 
then respecify your options and file specification. 

The input. ext and output. ext are the basic TOPS-10 file 
specifications. When you do not specify an output file specification 
in the SOS command, the input. ext is used. The input. ext may become a 
backup file (.Qxt or .Zxt), depending on the options (switches) set. 
If no backup file is to be created, output. ext may be used in a later 
SOS session as the input. ext. Otherwise, input. ext contains all of 
the changes made during an SOS session. 

Full file specifications may appear in the following format: 

dev: f ilnara.ext [p,pn,sfdl ,sfd2 ,sfd3 ,sfd4 ,sfd5] <nnn> 
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Where: 



dev: 
f ilnam 

.ext 

[p,pn,sfdl. 



<nnn> 



Defaults; 



dev: 



f ilnara 



.ext 



[p,pn,sfdl, 
<nnn> 



is a device (e.g., SYS:, DSKC:). 

6 or less alphanumeric 



is a filename with 
characters. 



is a file extension with 
alphanumeric characters. 



or 



less 



] is a directory path. The PfPn must be a 
project, programmer number. You may specify 
up to 5 sub-file-directories (sfd) within the 
directory path. The square brackets must be 
included if the directory path is specified. 

is a file protection code. The angle 
brackets must be included if the file 
protection code is specified. 



for all but /RUN: option, the default is 
DSK:. For the /RUN: option, the default is 
SYS: . 

has no default. This argument must be 
supplied. 

has no default as this argument is optional. 
For the /RUN: option, .EXE is the default. 
(Refer to Appendix D for a complete list of 
TOPS-10 standard file extensions.) 

] is your default path. 

is a TOPS-10 system default protection code, 
usually <055>. 



2.2 COMMAND LEVELS 

There are two command levels in SOS: 

1. SOS command level 

2. SOS input level 

An asterisk prompt character indicates that you are at SOS command 
level. A line number indicates that you are in SOS input level. To 
move between these two levels, press ESCape or give the Insert 
command . 
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2.2.1 SOS Input Line Format 

The format for SOS input level is: 

line number <TAB> line contents 

The line number consists of five ASCII numeric characters and may be 
any number up to 99999 that you specify with the Insert command and/or 
the MAXLN option. 

The <TAB> is a single ASCII character that appears as three spaces on 
your terminal following the line number. The spaces do not count as 
line positions, and some terminals do not show the <TAB> spacing. 
When you press <TAB> while inputting the contents of your file, the 
pointer will move from one to eight spaces to the right. In this way, 
your terminal is like a typewriter with tab positions every eight 
positions. This <TAB> spacing will count as the number of positions 
the pointer is moved to the right. 

If you are creating or editing a file that is to be used as input to a 
program or utility, the line numbers and <TAB> may be counted as line 
positions. In some instances, you may reference the line numbers with 
the program or utility. Refer to the program or utility manual for 
information on the validity of referencing line numbers as positions. 

The line contents may be any characters you enter and a line may 
contain up to 497 characters per line including spaces and tabs. 

If you press ESCape at the end of the line, you end SOS input level 
and enter SOS command level. If you press RETURN at the end of the 
line, you remain at SOS input level and SOS automatically types a new 
line number. 



NOTE 

If you press either ESCape or RETURN at 
the end of the line, SOS automatically 
inserts a carriage return-line feed as 
its line terminator. 
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2.2.2 SOS Command Level Format 

The format for SOS command level is: 

* (command) and any or none of the following: 

(line) (page) (position) (range) (content) 
(number) (option) 



Where: 



command may be any of the SOS commands described in 
Chapter 5, including the special characters 
used to move or locate the pointer. 

line may be any existing or nonexisting line 

number, line content, special characters, or 
arithmetic characters and a number. 

page may be any page number, existing or 

nonexisting, special characters, or 
arithmetic characters and a number. 

position may be any line or page number, or any of the 
following special characters: 

for current line or current page 
for first line or first page 
* for last line or last page 

range may be a position or line/page number with 

either an exclamation mark (!) or colon (:) 
and another position or line/page number. 

content may be any string of existing characters in 
your file and/or nonexisting characters in 
your file separated by the ESCape key 
character, and an optional range specifying 
line/page numbers and special options. 

number may be any positive integer less than 2''35. 

option may be any one of the following options: 

A = enter Alter mode (Find command) 

D = decide on each substitution (Substitute 
command) 

E = match uppercase/lowercase characters 
exactly (Find and Substitute commands) 

N = do not print contents of line (Find and 
Substitute commands) 

S = do not print line numbers (List and 
Print commands) and do not print 
contents of line (extend command) 
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2.3 CORRECTING TYPING ERRORS 

To correct typing mistakes while creating or editing a file in SOS, 
use any of four commands listed below: 

1. DELETE (or RUBOUT) key 

2. BACKSPACE key 

3. CTRL/R 

4 . CTRL/U 

These four commands operate in SOS just as they do in the TOPS-10 
command level. 



NOTE 

Depending on your terminal's physical 
characteristics, CTRL/R and CTRL/U may 
or may not echo on your terminal. 



2.4 STOPPING A COMMAND 

Within the SOS program are two control-character commands that may 
stop an SOS command. 

1 . CTRL/G 

2. CTRL/C 

To issue a control-character command, press the key labeled CTRL and 
the alphabetic character at the same time. 



2.4.1 Using CTRL/G 

To cancel any SOS command before you complete it with a carriage 
return, type CTRL/G twice. For example, suppose you begin to type in 
a Substitute command and then decide to cancel it before you finish. 
You simply type two CTRL/Gs and SOS then prints the asterisk prompt 
character, indicating a return to SOS command level. 

,SOB NUMBER ♦FOR QtT) 
Edit: NUMBER* FOR 
>i<S:L02$:l03 

t t 

( 1 SC } ( CTRL/(,) ((TRL/(.) 

CTRL/G will cancel the command and return you to SOS command level so 
that you can retype the SOS command. You must use CTRL/G twice before 
you press RETURN. You need not press RETURN after typing CTRL/G 
twice. 
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2.4.2 Using CTRL/C 

After you type an SOS command and terminate it by pressing the RETURN 
key, you may desire to stop the command if, for example, it were 
printing more than you need. When you type a CTRL/C, SOS stops the 
command execution and prints: 

YES? (TYPE H FOR HELP) : 

When you give the Find, Print, and Substitute commands, however, you 
must type two CTRL/Cs. The command will stop exactly where you typed 
the CTRL/Cs. 

When SOS prints YES? (TYPE H FOR HELP): and stops, you must type in 
one of the following six letters: 

Symbol Meaning 

C Continues the command at the place where you typed the 
CTRL/C. You must press RETURN to get the asterisk prompt 
character to return to the terminal screen. 

E Ends the command, ends the SOS session, and saves the file 
just as if you gave an End command. Only the substitutions 
that were printed on your terminal are included in the file. 
You must press RETURN after typing an E to make this command 
work properly. 

Q Quits the SOS session without saving the changes you made 
since you started editing the file or since the last World 
command. Typing Q gives the same results as giving an EQ 
command at SOS command level. 

M Moves you to TOPS-10 monitor command level. You may give 
any TOPS-10 command. If you give one that does not change 
the contents of memory, you may continue the SOS session 
without having affected the file in any way. You simply 
give the TOPS-10 command CONTINUE and press RETURN twice. 
If you do give a TOPS-10 command that alters the contents of 
memory, you will lose your previous edits back to the last 
backup of your file. 

R Returns you to the SOS command level after terminating the 
current command. Any substitutions that were printed on 
your terminal are included in the file. You must press 
RETURN after typing the R to get the asterisk prompt 
character to appear on your terminal. 

H Prints a list of the responses you can give to the YES? 
question. 
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The following example shows how to use two CTRL/Cs to halt an 
unsuccessful Substitute command. The example shows typing H and then 
R to return to SOS command level. 

I ^ ^ 

♦SOS NUMBER » FOR GiD 
Edit: NUMBER* FOR 
* ST YF>E:| PRINT* GiD 

00200 PRINT 101 

(CTRL/C) (CTRL/C) 

Yes? (Type H for help): H 
Type one of J 



C -" 

E ~ 

Q - 

M -• 
p _ 

Yes? 



to CONTinue automatically 
to end edit and close file 
to «uit (delete tenriPorary files) 
return to MONITOR now 

to do REEnter (terminate losing search etc*) 
(Type H for help) t R 



* 



2.5 GIVING COMMANDS IN AN INDIRECT COMMAND FILE 

An indirect command file is a file of SOS commands and options that 

you may use frequently during any SOS session. Using the @ (indirect) 

command and the file specification of the indirect command file 

containing the SOS commands (and options) , SOS will execute those 

commands in the file you are editing. (Refer to Section 4.3.2 for 
additional information on including options in an indirect command 
file.) 



2.5.1 Creating An Indirect Command File 

When you create an indirect command file, you may specify the letters 
CMD as a file extension, but these three letters are not necessary for 
the execution of an indirect command file, because you can use any 
three alphanumeric characters or none at all. The filename 
specification may be one to six alphanumeric characters. 

You can create an indirect command file for a commonly used SOS Print 
command sequence. This file when executed will print an entire file 
from the first line of the first page to the last line of the last 
page. 



CZ3 

♦ SOS P*CMD L^ii 

input: p»cmi;i 
00100 f-^/-':*/^ 

00200 * 

t 



lIDSKCtP^CMDJ 
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You can create an indirect command file for SOS options that are used 
only on specific occasions. For example, 

♦SOS OPT»CMD CEE) 



Input? 

00100 /CI. 28 QiD 

00200 /EXPERT QH 

00300 ^-^CASE QiD 

00400 



*E QlD 
[:dskc:(:)pt»cmd:3 

You can create an indirect command file for an SOS Substitute command. 
For example, 

QD 

♦ G0S/C12B S C«rP) 

1 r I p u 1 1 S 

1 S 1 1- 1 E ' ■■^■■- 1 H A I ' ■■■■■■^ ''tW.f Li 



! 

GO 



*E C Rfci ) 

[:dskc:b:] 



(Refer to Chapter 6, Typing Special Characters, for reference material 
on entering special control characters into a file within SOS.) 

When you create any indirect command file, it is not necessary to end 
the SOS session by removing the SOS line numbers. When you execute an 
indirect command file in an SOS session,, SOS does not read the line 
numbers. 



2.5.2 Using An Indirect Command File 

To use the indirect command file during an SOS session, you must be at 
SOS command level. Edit mode, and type the at-sign (§) , followed by 
the indirect command file specification. 
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In the example below, you create a file of three pages, and then 
execute the indirect command file, P.CMD, to print the entire file 
before ending the SOS session. 

GD 

♦ SOS SAMPLE ♦ TXT QlD 
Input; SAMPLE ♦TXT 

00100 THIS IS LINE ONE OP SAMPLE ♦ TXT GID 
00200 * 
t 

00100 THIS IS PAGE 2 OP SAMPLE ♦ TXT QiD 
00200 $ 

t 

( hSC ) 

%!/ * C wn ) 

00100 THIS IS PAGE 3 OP SAMPLE ♦ TXT CElD 
00200 * 
t 

*ep»CMDGID 

00100 THIS IS LINE ONE OP SAMPLE ♦TXT 



Pa<3e 2 

00100 THIS IS PAGE 2 OP SAMPLE ♦TXT 



P3^e 3 

00100 THIS IS PAGE 3 OP SAMPLE ♦TXT 

* 

The output printed on your terminal after executing an indirect 
command file is as follows: 

1. The contents that are produced from the indirect command, 
such as the printout from a Print command 

2. Any possible error messages caused by an incorrect command 
and/or an incorrect file that is being edited 

3. The results from any = (Give) command within an indirect 
command file 

When SOS has finished executing the command (s) from an indirect 
command file, SOS prints the following message on your terminal and 
returns to SOS command level. 

% Indirect EOF 

If you had set the EXPERT option, the message would appear on your 
terminal as follows: 

%CMEND 
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USING NULTIPAGE FILES 



At times you may create or edit a large file. Because the SOS utility 
program enters everything in page 1 (text page) by default, you may 
wish to break the file into smaller, more manageable portions called 
pages. The advantages to you in breaking your file into pages are the 
following: 

1. Your file will be more readable. 

2. Your file will be easier to reference. 

3. Your entire file may not reach Wrap Around. (Refer to 
Section 3.9.3.) 



3.1 SOS PAGE MARK FORMAT 

A page mark is a line number consisting of 5 ASCII spaces (instead of 
digits) , a carriage return ("M) , a form feed ("D , and three nulls 
(blanks) . The 3 nulls indicates the end of the line. Programs that 
look for page marks look for the 5 spaces as a line number. 

When SOS encounters a page mark, SOS will print the word PAGE on your 
terminal. When you give a Delete, Insert, Kill, or Mark command 
specifying a page number, SOS will increment or decrement the 
subsequent page marks accordingly. 

When you print your file on the line printer, the form feed embedded 
in the page mark will cause the line printer to skip to the beginning 
of a new form. The skip to a new form will also occur when you give a 
List command during an SOS session to list your file on the line 
printer . 



3.2 LINE AND PAGE NUMBERS 

To specify a particular line and page in your file, type the line 
number, a slash (/) , and then the page number. A number alone is a 
line number; a number preceded by a slash is a page number. 

Format: line number/page number 

Example: 500/3 (line 500 on page 3) 
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To specify a section of your file rather than a particular line, use a 
colon (:) to separate the limits of the range. 

Format: line number/page number: line number/page number 

Example: 100/1:600/3 

(line 100 on page 1 through line 600 on page 3) 

Some programs cannot work with SOS if SOS retains its line numbers. 
In addition, you cannot use SOS line and page numbers as labels for 
source-program statements such as GOTO. If a program gives you errors 
because of line or page numbers, start SOS, use the Kill command to 
delete the page marks, and use the ES command to end SOS and remove 
the line numbers. 

NOTE 

Refer to the reference manual for the 

particular source program and/or 

utility, because some programs 

automatically remove the line numbers 
and some do not. 



3.3 SPECIAL CHARACTERS FOR LINE AND PAGE NUMBERS 

Sections 3.3.1 through 3.3.4 make use of special characters you can 
use with many of the SOS commands or, in some cases, by themselves. 
These special characters place or move the pointer to a specified 
position within your file. 

NOTE 

The placement of these special 
characters is very important. For 
example, any character to the left of 
the slash substitutes for a line number, 
any character to the right of the slash 
substitutes for a page number. 



3.3.1 The Period (.) 

The period (.) specifies the current line or page number of your file. 

Example Explanation 

./3 current line on page 3 

200/. line number 200 on current page 

100/. : ./2 line number 100 on current page through current 
line number on page 2 
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NOTE 

The =. command shows the current 
position of the pointer in line/page 
format. 



3.3.2 The Asterisk (*) 

The asterisk (*) specifies the last line or last page number of your 
file. 

Example Explanation 

*/2 last line on page 2 

300/* line number 300 on the last page 

./* current line on the last page 

./.:*/* current line on the current page through the last 
line on the last page 



3.3.3 The Up-arrow (") 

The up-arrow (") specifies the first line or first page number of your 
file. 

Example Explanation 

"/. first line on the current page 

*/" last line on the first page 

"/" first line on the first page 

":* first line through last line (current page 

assumed) 



3.3.4 The Exclamation (I) 

The exclamation (!) when specified with a line number/page number 
format indicates the number of lines, including the first line. The 
exclamation can span page boundaries when the range specified includes 
the last line of the first page and the first line of the next page. 
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Example Explanation 

./•13 current line on the current page and two 

subsequent lines 

10014 line number 100 and the three subsequent lines 

/2 ! 3 first three lines on page 2 

*!3 last line on the current page, plus the two lines 

of the next page 



NOTE 

The exclamation (1) can be used in any 
SOS command that can take a range 
specification. When the exclamation is 
used, the range specified must be just a 
single line number/page number 
specification; it cannot have an ending 
line/page number. 



3.4 ARITHMETIC EXPRESSIONS WITH LINE AND PAGE NUMBERS 

Arithmetic expressions of addition and subtraction specify the next 
line number or page number, or a previous line number or page number. 
Arithmetic on line numbers and page numbers can proceed forward or 
backward from the current line including line increments and any prior 
changes. Arithmetic and special characters affect line numbers only 
on the current page. To cross pages, use the exclamation (1). 

Example Explanation 

.+2 third line from the current line on the current 

page (current page assumed) 

/.-I current page minus one; that is, the previous 

page 

/3-1 page 2 

*/l+2 last line on page 3 

100+2/2 line 00300 on page 2 (assuming the SOS increment 
default of 100) 

100+2/. -1 line 00300 on the previous page (assuming the SOS 
increment default of 100) 

950/.+112 line number 950 on current page, plus the first 
line on the next page. 

(Refer to the remainder of Chapter 3 for actual examples using special 
characters and arithmetic operations.) 
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3.5 CREATING MULTIPAGE FILES 

When you create a new file, SOS enters everything into page 1 by 
default. If your file is large or contains line numbers greater than 
99900 (the SOS default of the START and INCREMENT options) , you should 
create another page to avoid Wrap Around and allow your input to 
continue. You can create another page by using either the Insert or 
Mark commands at SOS command level. The Insert command inserts a page 
mark after the line where the pointer is currently positioned. The 
Mark command marks any desired line number as the first line of 
another' page. (Refer to Chapter 5, SOS Command Descriptions, for an 
in-depth description of these two commands.) 

The example shown below and in the remainder of Chapter 3 is a FORTRAN 
source program. When executed, this program allows you to enter two 
numbers and the program will return the sum and difference of the two 
numbers. There are mistakes in the text of the program for SOS 
example purposes. 



.sosG 


*m) 




FILI::.; 


NUMBER ♦ 


FOR ( KfT ) 


input: 






00100 


TYPE 


101 («" ) 


00200 


101 


FORMAT ( ' TYPE TWO NUMBERS 


00300 


ACCEF- 


•T 102rAyBC.5!lJ 


00400 


102 


FORMAT (2F)C«et) 


oosoo 




CALL ADriEM(AyB) ( «" ) 


00600 




CALL D:[FFER<AyB) ( Rtr ) 


00700 




STOP ( -tT ) 


00800 




END ( KET ) 


oovoo 


C 


THIS IS AN EXAMPLE FORTRAN 


01000 


t 





$)Qi7) 



PROGRAM QeD 



This text has been entered into page one of a file. To create another 
page at this point, give the Insert command to put the pointer at the 
beginning of a new page and enter Input mode. SOS will automatically 
increment the page number by 1. The line numbers will start with the 
SOS default of 00100, with increments of 100. You can change these 
defaults with the INCREMENT and START options. To leave Input mode, 
press Escape. 

*i/* QtD 

00100 THIS SUBROUTINE ADDS THE TWO NUMBERS (^ID 
00200 SUBROTINE ADDEMM< A » B )G1D 
00300 C - A f bGID 

0040 r Y r- e i o i >- c ( «" ) 

'5 1 1 F- R M A T < '' T H E S U MM I S S { 7 y F ) CUD 
00600 RETURN CED 

0070 S U B R U T I N £ B I F F li- R ( A y B ) C^^ 

00800 C ■■■■■■■■ ABBZ(A - B ) ( "" ) 

00900 101 FORMAT (' THE DIFERENCE IS J 'Ff )C^^ 
01000 ENDI^- 

t 
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The remainder of the source code has now been created and entered on 
page 2 of the file. At this point, mark line number 700 as the next 
page, page 3. 

Lines 700 through 1000 are now the contents of page 3. Before ending 
the SOS session, print the entire file. End the SOS program without 
creating a QOR extension backup file. 



NOTE 

Refer to the reference manual for the 
particular source-program you are using 
because some compilers may or may not 
remove the SOS numbers from the input 
file. If they do not, you must end the 
SOS session with the ES command in order 
to strip them off. 



00100 
00200 
00300 
00400 
00500 
00600 
00700 
00800 
00900 

PAGE : 

00100 

00200 

00300 

00400 

00500 

00600 



TYPE 101 



101 

ACCEPT 

102 



FORMAT 
102rArB 
FORMAT 
CALL 
CALL 
STOP 
END 
THIS 



< ' TYPE TWO NUMBERS 

( 2F ) 
AIiDEM(AfB) 
DIFFER(ArEO 



*) 



IS AN EXAMPLE FORTRAN PROGRAM 



THIS SOBROUTINE ADDS THE TWO NUMBERS 
SUBROTINE ADDEMM<ArB) 

C ■■^■■■- A f B 

TYPE 101,C 



101 



FORMAT 
RETURN 



( ' THE SUMM I SB; 7ff) 



PAGE 3 

00700 

00800 

00900 

01000 

*EB GiD 



101 



SUBROUT I NE D I FFER < A r B ) 

C =•• ABS2(A - B> 

FORMAT (' THE DIFERENCE ISS: 

END 



F) 



[; DSKC : NUMBER ♦ FOR l. 27 » 5 1 07 J J 
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3.6 EDITING MULTIPAGE PILES 

If you attempt to execute the FORTRAN program in Section 3.5, the 
FORTRAN compiler will return numerous errors: there are mistakes in 
the source code as well as a few missing lines. 

Below are several examples and explanations used to edit this 
multipage source program code. When completed, this program will 
execute properly without any error conditions. 



NOTE 

If any of the commands are unfamiliar, 
please refer to Chapter 5, SOS Command 
Descriptions. 



Start the SOS program using the same file specification as in the SOS 
session in Section 3.5. The default page is page 1 at the start of 
the SOS session. Alter the first three lines as follows: 



»sos GlD 

edit: number. for 

00100 



TYF'E 101 



00200 



00300 



101 f-GRMAT <' TYPE TWO NUMBERS : W : W '*) 



t 

2s: 



t 



ACCEPT 102rArB 



Transfer line number 900, creating line number 50 (page 1 assumed) 

*T50!.900 GlD 
I NCI- 000 50 
* 

Print the contents of page 1 to show its current format. 



00050 
00100 
00200 

00:500 

00400 
00500 
00600 
00700 
00800 
* 



C THTB IS AN EXAMPLE FORTRAN PROGRAM 
TYPE 101 

101 FORMAT <' TYPE TWO NUMBERS J '*) 
ACCEPT 102fAyB 

102 FORMAT <2F) 
CALL ADi;iEM(A»B) 
CALL DIFFER < A vB) 
STOP 

END 
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Alter the first two lines of page 2. 

00100 c THIS subf:out.tnf: adds thk two numbers 



I 



.icQK)ClD so 

00200 SUBROUT .t NE ADDEMWMW ( A r B ) 

t ft t 

t t 2SM t'GID 

iQZDGED BO 
* 

Substitute IBS for IS on page 2. Then make the same substitution on 
all of the remaining pages in the entire file. 

C ES( X tH ^ 

♦ siss*is$ ChD 

00500 101 FORMAT (' THE SUMM IS: 7rE) 

*s* GiD 
t 

PAGE 3 

00900 101 F-ORMAT (' THE BIFERENCE IS: '»E) 

* 

Find the numeric location of the pointer. 

*=♦ ( KM ) 

00900/3 

Return to the first line of page 2. 

'*<."/ ♦-1 QiD 

Substitute SUMM for SUM and 7 for ' in page 2. 

*'3SUMM ri^TT ) 
7*SUMC«rr) 

00500 101 F-ORMAT (' THE SUM ISt ' » F ) 
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Copy line number 1000 of page 3, creating it as line number 700 of 
page 2. 

■>\^C700y 1000/ .M QiD 
* 

Move the pointer to the first line of page 3. 
Insert two lines at the beginning of page 3. 



M I -' ( KM ) 

00.1.00 C 
00200 C 



THIS SUBROUTINE SUBTF<ACTC THE.- LESSER Q^FT) 
NUMBER FROM THE LARGER NUMBER* 



Alter line numbers 800 and 900 of page 3. 



*A»+2!2 GH 
00800 



00900 101 



t 

2SF 



C ■■=- ABS\\Z\\<A - B) 
t 

D GID 

FORMAT ('THE DIFFERENCE IS: 'rF) 



! 



IF 



KSC ) { RtT 



Copy line number 400 of page 2, creating it as line number 850 of page 
3. Copy line number 600 of page 2, creating it as line number 950 of 
page 3 . 

*C850/3r 400/2 GED 
INC1^00050 
*C9^0/;3» 400 + 2/2 GTT) 
I NCI ^^=00050 

Move the pointer to the beginning of page 3 and renumber the contents 
of page 3. 

^ t " /3 (kit) 
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Print the entire contents of the file NUMBER. FOR. End the SOS session 
with no .QOR file extension backup; i.e., exit using either EB or ES 

depending on your compiler. 

*F"Vi:*/3C5iD 

00100 C THIS :tS AN EXAMPLE F"OF\'TRAN PROGRAM 

00200 TYPE 101 

00300 101 FORMAT <' TYPE TWO NUMBERS: '*) 

00400 ACCEPT 102»A>B 

00500 102 FORMAT ( 2F ) 

00600 CALL ADDEM(A»B) 

00700 CALL DIFFERS A»B) 

00800 STOP 

00?00 END 

PAGE 2 

00100 C THIS SUBROUTINE ADDS THE TWO NUMBERS 

00200 SUBROUTINE ADDEM(AfB) 

00300 C -" A + B 

00400 TYPE 101 rC 

00500 101 FORMAT (' THE SUM IS: '>F) 

00600 RETURN 

00700 END 

PAGE 3 

00100 C THIS SUBROUTINE SUBTRACTS THE LESSER 

00200 C NUMBER FROM THE LARGER NUMBER 

00300 S U B R U T I N E D I F I ■ E R < A :- B ) 

00400 C ■■■■■■■■ ABS(A - B) 

00500 TYPE 101 rC 

00600 101 FORMAT (' THE DIFFERENCE IS: '>F) 

00700 RETURN 

00800 END 

*EB 

[: DSKC : NUMBER » FDR i: 27 y 5 1 07 J :i 



3.7 DELETING LINES IN MULTIPAGE FILES 

You can give the Delete command to delete any line from your file. If 
you do not specify a page number in the Delete command, action will 
take place on the page you are currently editing. To delete a line on 
a page other than your current page, you must specify the page number 
in the Delete command. 

Delete line number 200 on page 1. Page 1 is the current page at the 
start of the SOS session by default. 

. S S N U M B E R . F R (jlD 

edit: number. for 

*D200 GID 

I lines (00200/1) DELETED 
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Delete line number 200 on page 2. 

)KD200/2 GiD 

;l. LINES (00200/2) DELE TED 

% 

If you want to delete the entire contents of a page, SOS will reply to 
the Delete command with a decision message, giving you the option of 
cancelling the deletion. You must reply with either Y for YES or N 
for NO. Any other character will have no effect on the message and 
SOS will repeat the same message. 

This message does not depend on the setting of any SOS options, except 
the EXPERT option. With the /EXPERT option set, the message MASSIVE 
DELETE OK? will not appear and the deletion will occur. This message 
may also be suppressed with the Y option of the Delete command. 
(Refer to Chapter 4, EXPERT option, and Chapter 5, Delete command, for 
an in-depth description of these SOS features.) 



or 



*D'V3:*/3 

MASSIVE DELETE OK? (Y OR N) : A 

? YOU MUST TYPE EITHER <Y OR N): NO 



♦D/3 ri^TT) 

MASSIVE DELETE OK? <Y OR N): NO 



When you type Y for YES or N for NO, you do not need to press RETURN. 
SOS replies with ES of YES or of NO. 

The Delete command does not delete the page mark within your file. 

*/EXF-'ERTCl!D 
>KD/3 QiD 
♦:P/3 QiD 

PAGE 3 
The contents of the page have been deleted, but the page mark remains. 
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When you delete a range of lines that extend from one page into 
another page and the deletion includes all lines of the second page, 
that deletion will remove the page mark of the second page and will 
decrement by 1 all subsequent page numbers. Page one always remains a 
numbered page (but without a page mark) . 

M D<>00/i:700/2QiD 

MASSIME delete: OK? (Y OR N): ^S 

8 LINES (00900/1:00700/2) DELETED 

* p"/i :>«(/* o^T ) 

00100 C THIS IS AN EXAMF'LE FORTRAN PROGRAM 

00200 TYF'E 101 

00300 101 FORMAT <' TYF-'E TWO NUMDERS r '*) 

00400 ACCEPT 102rA»B 

00500 102 FORMAT < 2F ) 

00600 CALL ADDEM(AyB) 

7 C A I... L 1.1 1 F F E R < A » B ) 

00800 STOP 



PAGE : 

00100 

00200 

00300 

00400 

00500 

00600 

00700 

00800 

* 



101 



THIS SUBROUTINE SUBTRACTS THE 
NUMBER FROM THE LARGER NUMBER 
SUBROUT I NE D I FFER ( A y B > 



C ^-^ ABS<A 
TYPE 101 fC 
FORMAT ( ' 
RETURN 
END 



- B) 



THE DIFFERENCE IS 



LESSER 



F) 



Page marks exist between pages. In a two-page file, there is only one 
page mark, the one for page 2. There is no page mark for page 1. 
Therefore, a one-page file contains no page mark. 

There are programs that read page marks (FORTRAN, PASCAL, and so 
forth) , and it is important to these programs exactly where such page 
marks are located. (Refer to the reference manual for the program 
language being used to learn how it handles page marks within a file.) 



Of course, if you make any deletions by mistake, 
file by ending the SOS session with an EQ. 



you can save your 
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3.8 KILLING PAGE MARKS IN MULTIPAGE FILES 

You can use the Kill command to delete any specified page mark from a 
file. If you specify page 1 with the Kill command, the error message 
%N0 SUCH PAGE will appear because there is no page mark for page 1. 

When you use the Kill command on a particular page mark, the line 
contents are appended to the previous page. If you kill all page 
marks within a file, then the contents of those pages become the 
contents of page 1. 

If each page contains its own line-number sequence in ascending order 
(i.e., the first line number is less than the last line number from 
the previous page), the following warning message will appear. At 
this point you must use the Number command to resequence. 

<. sos number ♦fof^qet) 
£d:i.tj number ♦for 

^ K/2 QHT) 
/,'OUT OF ORDER 

■^■■ 

If you kill a page mark of an existing page within a file but not the 
last page, each remaining page number will decrement by 1. 
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*K/2 ( «ET 


:> 




r.OUT OF 


ORIit-R 




*N (RtT^ 






*P^/i:*/* OTTT) 




00100 


C 


THIS IS AN EXAMPLE FORTRAN PROGRAM 


00200 




TYPE 101 


00300 


101 


FORMAT <' TYPE TWO NUMBERS: '*) 


00400 




ACCEPT 102»A,Ei 


00500 


102 


FORMAT <2F) 


00600 




CALL ADDEM(ArB) 


00700 




CALL DIFFER(ArB) 


00800 




STOP 


00900 




END 


01000 


C 


THIS SUBROUTINE ADDS THE TWO NUMBE 


01100 




SUBROUT I NE ADDEMM ( A y B ) 


01200 




C ^^■■■- A f B 


01300 




TYPE 101 rC 


01400 


101 


FORMAT ( ' THE SUM IS: ' rF) 


01500 




RETURN 


01600 




END 


PAGE 2 






00100 


C 


THIS SUBROUTINE SUBTRACTS THE LESSI 


00200 


C 


NUMBER FROM THE LARGER NUMBER 


00300 




SUB R U r I N E D I F- F E R ( A ? B ) 


00400 




C ■■■■^■- ABS(A - B) 


00500 




TYPE 101 tC 


00600 


101 


FORMAT (' THE DIFFERENCE IS: 'jF) 


00700 




RETURN 


00800 




END 



Page 3 of our FORTRAN source program is now page 2. 

(Refer to Chapter 5, SOS Command Descriptions, for an in-depth 
description of the K command.) 



3.9 RENUMBERING LINES IN MULTIPAGE FILES 

When you create or edit a file, the SOS program has a line-number 
default sequence of 00100 through 99900 with increments of 100. If 
you create a file with more than 1,000 lines of text, it is 
recommended that when you reach line 99900 you should renumber your 
file or create a new page starting with line 00100. 

You will find it easier to type line numbers in increments of 1, for 
example line numbers 00001, 00002, 00003, and so forth, because you 
will not have to type the trailing zeros. When you use line numbers 
in multiples of 10 or 100, you can insert lines between existing lines 
within your file. The N command renumbers the lines in your file. 
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3.9.1 Renumbering Your File 

When you use the SOS Number command to renumber your file, type N and 
press RETURN. SOS will then renumber your file (regardless of page 
marks) starting with 100 and adding 100 to each sequential line 
number. After renumbering, SOS positions your pointer at the end of 
your file. 

For example, suppose file NUMBER. FOR is numbered from 10 in increments 
of 10. 



♦ SOS NUMBER ♦F OR QeT) 

edit: number* for ♦! 
*p":* GtT) 

00010 

101 



00020 
00030 
00040 
00050 
00060 
00070 
00080 
00090 
00100 

)|C N ( RET ) 

*:p c^rr^ 

01000 



102 
103 

104 



TYPE 101 

FORMAT (' PLEASE TYPE A NUMBER*') 

ACCEPT 102 »X 

FORMAT <F) 

TYPE 103yX 

FORMAT (' YOU TYPED THE NUMBER 'rF) 

Y ===• 2 * X 

TYPE 104yXrY 

FORMAT (' TWICE 'rf IS 'rF) 

END 



END 



Renumber the file by giving the N command. SOS positions your pointer 
at the end of your file. Now print the entire file again. 



*p":* ( 


[ KtT ) 


00100 




00200 


101 


00300 




00400 


102 


00500 




00600 


103 


00700 




00800 




00900 


104 


01000 




* 





TYPE 101 

FORMAT (' PLEASE TYPE A NUMBER*') 

ACCEPT 102yX 

FORMAT <F) 

TYPE 103fX 

FORMAT < ' YOU TYPED THE NUMBER ' y 

Y =: 2 * X 

TYPE lOArXfY 

FORMAT <' TWICE '»Fy' IS 'yF) 

END 



F) 



The contents of each line do not change, 
change. 



Only the line numbers 
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3.9.2 Renumbering Using A Number Other Than 100 

When you want to use some number other than 100 to renumber, type N 
followed by the number you want to use. Your file will begin with 
that number and will also increment by that number. You can use any 
number or combination of numbers within the range of 1 to 99999. In 
the following example, the file has been renumbered with increments of 
15. 

00015 TYF't:"; 10.1 

00030 101 F-OKMAT (' F'LE-IABE TYPE A NUMBER.') 

00045 ACCEPT 102 rX 

00060 102 F-ORMAT (F) 

00075 TYPE 103 rX 

00090 103 FORMAT (' YOU TYF-'EH TF^E NUMBER ' f F" ) 

00105 Y ----^ 2 * X 

00120 TYPE lOAvXfY 

00135 104 FORMAT (' TWICE ' yfr ' IS 'rF) 

00150 END 



3.9.3 Wrap Around 

When you create or edit a file and you exceed the number of lines 
allowed on one page (default is 99900 with 100 as the increment or 
99999 with 1 as the increment) , SOS will not allow you to enter any 
more lines until you either renumber your file or create a new page to 
resolve a possible Wrap Around. 

When you renumber a file with too large a number, you will quickly 
reach Wrap Around and the following message will appear on your 
terminal : 

%WRAP AROUND 

followed by the page number that contains the Wrap Around. To remedy 
this situation, type the following commands to Mark the current line 
as the beginning of a new page and then to renumber that page. 

*M. GID 
+'N100t/2 GID 

The example below is a 15-line file that has been renumbered with an 
increment of 10000. 

. S S SAM F- 1.„ E . I X T QiD 

edit: sample.txt 
*Nioooo Oil) 

%WRAP AROUND 
PAGE 1 
50000/1 



50000 LINE 15 y PAGE 1 
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At this time, use the Print command to see which lines contain Wrap 
Around; i.e., which lines are duplicates of or are less than numbers 
that precede them. For example, suppose the entire file appears as: 



«F'/i:/2 QeT) 



PAGE 1 

10000 

20000 

30000 

40000 

50000 

60000 

70000 

80000 

90000 

00000 

10000 

20000 

30000 

40000 

50000 



LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 
LINE 



3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 



PAGE 1 

PAGE 1 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 

PAGE 



The Wrap 
command: 



Around duplicate-lines showed when you used the Print 



*p"':* 

00000 
10000 
20000 
30000 
40000 
50000 



LINE 
LINE 
LINE 
LINE 
LINE 
LINE 



10 
111 

12: 

13 1 
14: 

15: 



PAGE 
PAGE 
PAGE 
PAGE 
PAGE 
PAGE 



The lines themselves are in the proper order, but the line numbers are 
not in increasing order. Before you do anything else, fix the line 
numbers. To do this, give the N command with a smaller number than 
you had previously given. 



*N1000 


QE) 








*p' :*C 


RET ) 








01000 


LINE 


1» 


PAGE 




02000 


LINE 


2? 


PAGE 




03000 


LINE 


3y 


PAGE 




04000 


LINE 


Af 


PAGE 




05000 


LINE 


5 r 


PAGE 




06000 


LINE 


6y 


PAGE 




07000 


LINE 


7y 


PAGE 




08000 


LINE 


8y 


PAGE 




09000 


LINE 


9y 


PAGE 




10000 


LINE 


10» 


PAGE 




11000 


LINE 


lly 


PAGE 




12000 


LINE 


12 r 


PAGE 




13000 


LINE 


13 y 


PAGE 




14000 


LINE 


14? 


PAGE 




15000 


LINE 


15r 


PAGE 




* 
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CHAPTER 4 
USING SOS OPTIONS 



Just as the Input, Edit, and Alter modes (see Chapter 1) modify the 
SOS program, options also modify SOS. They perform various functions. 
Some options supply a value; the PLINES option, for example, alters 
the number of lines normally printed by a Print command. Other 
options are either on or off, for example the DECIDE option which 
causes the Substitute commands to enter the decide mode. Still other 
options such as the Period (.) option provide information. 



4.1 OPTION FORMAT 

Each option has a name and some have values preceded by a colon (:) or 
an equal sign (=) . The colon or equal sign can be used 
interchangeably. Thus, the format of a valued option is: 

optionrvalue or option=value 

while the format of an "on-off" option is: 

option 

When printing or setting an option, all you have to do is type enough 
characters to uniquely identify the option name. Thus, INC is 
sufficient for INCREMENT, and LOC is sufficient for LOCATION. 



4.2 THE SWITCH.INI OPTION FILE 

You can create a file in your logged-in directory containing any of 
the settable options of the SOS program. This file must be called 
SWITCH.INI. The SWITCH.INI option file may contain as many SOS option 
lines as you wish. When you type the TOPS-10 SOS command on your 
terminal, SOS extracts the options specified in the SWITCH.INI file as 
part of that SOS session. If there is no SWITCH.INI option file in 
your directory or if the file contains no options for SOS, SOS uses 
its own default options. 

If you misspell an option in the SWITCH.INI file, SOS will reply with 
an error message when you start the SOS program. For example, if your 
SWITCH.INI file contained the following line: 

» TYPE SWITCH* INI CID 
00 :l 00 SOS/SEPERATORS 



4-1 



USING SOS OPTIONS 

this error condition would cause your SOS program session to start as 
follows: 

♦ SOS NUMBE.R . FOR GiD 

? Syntax error in default options 

file;:: 

Section 4.4 and Appendix B contain a detailed description of all the 
available SOS options and their defaults. 



4.2.1 SWITCH.INI Option File Line Formats 

The two possible line formats of the SWITCH.INI option file are: 

1 . SOS/optionl/option2/option3 . . . [/RUN:dev:program-name] 

2. SOS: name/opt ionl/option2/ [/RUN:dev:program-name] 

You may use either or both formats in the same file, but SOS must be 
the word SOS. If you try to use any word other than SOS, SOS ignores 
the contents of the SWITCH.INI file and uses its default options. 

In the second format, name can be up to six alphanumeric characters 
and is used as a pointer with the Set /OPTION command (/OPTION: name) . 
This type of line is used to override both the system defaults and 
your specified parameters that were given in a previous format. Thus, 
if you have a line format in your SWITCH.INI option file with a 
pointer name, your defaults for that line can only be set with the Set 
/OPTION command. If the pointer name used in the Set /OPTION command 
does not appear in the SWITCH.INI file, the SOS program outputs an 
error message and uses its defaults or previously set parameters. 

*/option:allGh3 

? Option not found 
* 

If an option is misspelled within a line that has a pointer name, SOS 
replies with an error message and the Edit mode prompt character. 

*/option:all cET) 

? Syntax error in option file 
* 

In both formats, the option (s) may be any of the settable SOS options 
described in Section 4.4 and Appendix B. Also, in both formats there 
are the optional switches specified by the word RUN. When using this 
RUN option, you can end an SOS session with the Go command, and 
immediately enter the program specified by the program-name. The dev 
is the device on which the program-name resides. The SOS default for 
this is SYS. 



4.2.2 Including An Option In Your SWITCH.INI File 

If you want a particular option to be always in effect, include it in 
your SWITCH.INI file. Whenever you start the SOS program, all of the 
options you include in the SWITCH.INI file are automatically set. You 
must use the line format shown in the example below: 
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♦ SOS SWITCH* INI C2ID 

input: switch* INI 

00100 S0S/0LD/N0BAK/EXPERT/C128 QE) 
00200 $ 
t 

GD 

*E 



[:EiSKC:SWITCH» INI C27» 51073 D 

* 

If the options you desire take up more than one line in the SWITCH.INI 
option file, add a hyphen to the end of each line that will be 
continued. 

♦ SOS SWITCH* INI GK) 

edit: switch* INI 
*RiooQID 

00100 SOS/DECiriE/NOBAK/OLi:i/START:iO/STEF':iO~CKlD 
00200 /INCREMENT :iO/EXPERTQEr) 

00300 * 

t 

*eC«ID 

[.DSKC: SWITCH* INI 1:27 ^5107:3 3 

* 

Since the /EXPERT option was placed in the SWITCH.INI file when it was 
created above, the /EXPERT option remains in effect even when you edit 
the SWITCH.INI file. Thus, if you place an option, such as READONLY, 
in your SWITCH.INI, file you may have to delete your SWITCH.INI file 
and re-create it. To delete a file in your directory, use the TOPS-10 
DELETE command. 

When you use "program-name" within your SWITCH.INI file, unsequence 
your SWITCH.INI file, because some programs do not recognize SOS line 
numbers. To unsequence the SWITCH.INI file, give the ES command when 
you save it. 



4.2.3 Multiple Lines/Formats Within Your SWITCH.INI File 

The SWITCH.INI file may contain many SOS/option lines within it for a 
variety of purposes. If your SWITCH.INI file contains more than one 
SOS/option line having the SOS/optionl/. . . format, the first line of 
the SWITCH.INI file will be the options that prevail for the SOS 
session. For example, if your SWITCH.INI file contained the following 
contents: 

* TYF-'E SWITCH* INI GE) 

00100 SOS/EXPERT/NODECIDE/NOBAK 

00200 SOS/NOVICE/DECIIIE/BAK 

* 

then the options as specified on line number 00100 would be the 
options used when you start an SOS session. 

Therefore, it is recommended that you use just one line with the 
SOS/optionl/.... format. 
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The second format, SOS : name/opt ionl/. ... , may be in multiple forms 
with each "name" being different. The options can only be set with 
the /OPTION: name command at SOS command level. For example, if your 
SWITCH.INI file contained the following line: 



*TYPE SWITCH ♦INI GiD 

00100 S0StALL/liEXPERT/N0DECIDE/N0BAK/ISAyE::25/SAVE:25 

* 

then you must give the Set option command to set the options specified 
by ALL- 

»/OF-'T ION? ALL C^iT) 

The following is an example of the creation of a SWITCH.INI file that 
allows you to enter succeeding SOS sessions using your own option 
parameters, return to the SOS default options, and return to your own 
option parameters without leaving the SOS program. 

♦SOS SWITCH* INI GiD 

inf-'Ut: switch* INI 

00100 S0S/EXPERT/C128/START;i0/INCF;:EhENT:i0-r^FP) 

00200 /5EPARAT0RS/N0BAK/M;'53 CmD 

00300 S0StriEF/BAK/C64/N0^^ICE/N0NSEPARAT0RB~ C«T 

00400 /START : 1 00/INCREMENT : 100/h37 CT^ 

00500 SOS : M0DE/EXPERT/C128/START : lOT^ 

00600 /separators/increment: 10/N0BAK/M33CIJr) 

00700 



( ESC ) 
'^■E ( RET ) 

L DSKC : SW I TCH ♦ I N 1 1 27 r 5 1 07 J 1 
♦ SOS NUMBER ♦ F' OR QID 

edit: number J-- or 

*^^^'CASE CEE) 
Separators Ui^-'er 

*/option:defGeD 

^■•■^^■CASE QF3 

Disple'.:; Model '37 C6A UpF(?r 

*/0PT I on: MODE GiD 

*^^^'CASE GiD 
Separators Upper 



4.3 SETTING OPTIONS 

In summary, you may set an SOS option by: 

1. Including it in your SWITCH.INI file (See Section 4.2.2.) 

2. Giving it with an SOS command (See Section 4.3.1.) 

3. Including it in an indirect command file (See Section 4.3.2.) 

4. Giving it from Edit mode (See Section 4.3.3.) 
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To set any settable option in SOS, you must use the slash (/) 

character to precede the option specified. The slash (/) character is 

the Set command and can be used in the SWITCH.INI file, with the SOS 

command, in an indirect command file, or at Edit mode. 



4.3.1 Giving An Option With The SOS Command 

To set an option while starting the SOS program, simply include it 
after the command name and either before or after the file 
specification. 

( SP ) 

♦ SOS SAMPLE ♦ TXT/START : 10/INC J lO/EXPERTQiD 

input: sample ♦TXT 

00010 



or 



♦ SOS/START : 1 0/INC : 10/EXPERT SAMPLE ♦ TXT dhD 
edit: sample ♦TXT 

* 

The two examples above show the SOS command setting the START, 
INCREMENT, and EXPERT options. 

When you give option (s) with the SOS command, the' SOS program will 
first extract any options supplied in the SWITCH.INI file and then use 
the options supplied with the SOS command. That is, if an option 
given in the command overrides an option from the SWITCH.INI file, 
then that is the option used for the SOS session. This would happen, 
for example, if the line in the SWITCH.INI file contained: 

♦TYPE SWITCH* INI GiD 

00100 S0S/EXPERT/C128/N0BAK 

♦ 

and the SOS command contained: 

♦ Sns/C64./DECIDE SAMPLE ♦ TXT C^J 
edit: sample ♦TXT 

* 

C64 would override C128, and DECIDE would add DECIDE mode to EXPERT 
mode. NOBAK would remain in effect for the SOS session. 

NOTE 

Adding DECIDE mode to EXPERT mode 
enables you to make decisions with the 
Substitute command while the 
characteristics of EXPERT mode remain. 
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4.3.2 Including An Option In An Indirect Command File 

You may use an indirect command file, for example, to set an SOS 
option, perform SOS command (s), and then either preserve or reset that 
option or any options in the SWITCH.INI file. Below is an example of 
an indirect command file that sets the C128 option, substitutes the 
dollar sign character ($) for an Altmode character (ESCape key 
character), substitutes an up-arrow (") C for the CTRL/C character, 
and resets the options specified by the pointer name DEF in the 
SWITCH.INI file. 

»SaS/C128/E.XPERT S.CMnGED 

input: s»CMri 

00100 /C128CKtD 

00200 s* O^ro 

00300 -^0'===' '--' GtD 

00400 ''*'■■■■--"/-' i^/^CET) 

00500 /0PTi0N:LiE:r CsID 

00600 * 

t 



[:DSKc:s»cMra 

This S.CMD file, when executed by the Indirect command (@) , will place 
the Escape character and the CTRL/C character into a file wherever a $ 
character and "C character exist. (Refer to Chapter 6, "Typing 
Special Characters," for an explanation of entering special characters 
into a file.) 



4.3.3 Setting An Option From Edit Mode 

To set an option from Edit mode, use the Set command; that is, simply 
type a slash character (/) and the option. You may set any option 
that Section 4.4 describes as settable. The following example sets 
the ISAVE and SAVE options to 10 at Edit mode. 

*/isa^^e: 10 GiD 
*/sAVt::io CED 
* 

Using the Set command is another way to override an option in the 
SWITCH.INI file. 
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4.3.4 Finding The Status Of An Option 

To find the value or status of an option, use the Give command; that 
is, type an equal sign (=) and the name of the option you want. 
However, not all options are printable, and if you attempt to print 
the value or status of a nonprintable option, the error message 
%ILLEGAL COMMAND appears on your terminal. The following example 
finds the value of the START option. 

* STAR 7 C^T) 
00100 

* 

You may also give the =CASE command for information on some commonly 
used SOS options. (Refer to Section 4.4.6, CASE, for a description of 
this option.) 



4.4 DESCRIPTION OF OPTIONS 

The following sections describe all of the valid SOS options. For 
each option, the section describes its name, whether you can set or 
print the option, its default value, how to reverse its setting, the 
function of the option, an example of the option in use, and any 
applicable restrictions. Each option is shown in its acceptable 
abbreviated form. The brackets ([]) enclose optional characters. 

Those options that cannot be set or printed will display the error 
message %ILLEGAL COMMAND on your terminal if you attempt to set or 
print them. 

Not all options that are settable can be set in the SWITCH.INI file or 
with the SOS command. For example, the NAME option can only be set at 
SOS command level. Edit mode. 
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Settable: 


Yes 




/BAK 


Printable: 


Yes 




=BAK 


Default: 


On 


Reverse: 


By s 


Function: 





By setting the NOBAK option 



The BAK option causes the SOS program to rename the original file 
being edited. The file is renamed with a file specification of the 
same filename but with a file extension that begins with a Q, The 
contents of the file exist as if no edits were performed. The Qxt 
file (where xt is the last two alphanumeric characters of the file 
extension) is kept when you issue the End, Go, or World command. 

Example of setting BAK: 

*=BAK ( RET ) 

BACKUP F-ILE- WILL BE: CREIATED 

* 

Example of reversing BAK: 

*/NOBAK QiD 

*-BAK ( KtT ) 

NO BACKUF- FILE WILL BEi. CREATED 

* 

Remember that although deleting a backup file will save disk space, it 
is safer to retain the file until you have examined your new file. 



Restrictions: Not Applicable 
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BASIC 



4.4.2 BASIC 
Settable: 

Printable: 
Default: 
Reverse: 
Function: 



Yes 
/BAS[IC] 

Not Applicable 

None 

Not Applicable 



The BASIC option should be specified with the SOS command when you 
start an SOS session to edit a file that was created by the BASIC 
program. When you set the BASIC option, SOS will accept the line 
number labels of BASIC as the line numbers of the SOS session. If the 
BASIC option is not set, SOS will not recognize the labeled line 
numbers in the BASIC program. Thus, your BASIC file will contain two 
line numbers for each line. 

Example: 

The following file, SQUARE. BAS, was created in BASIC: 

♦ r Y !•■• t;; s q u a r e;: ♦ b a s QeD 

10 LET x-i 

20 PRINT XySQR(X) 

30 LET X^-==Xfl 

40 IF X<-^5 GO TO 20 

50 END 

» 

Without setting the BASIC option with the SOS command, your file would 
appear as follows: 



♦ SOS SQUARE ♦BAS (ret ) 




edit: SQUARE* BAS 




*P( HET ) 






00100 


00010 LET X= 


= 1 


00200 


00020 PRINT 


X»SQR<X) 


00300 


00030 LET X== 


=X+1 


00400 


00040 IF X<> 


=5 GO TO 20 


00500 
* 


00050 END 





With the setting of the 
follows: 



BASIC option, your file would appear as 



. SOS SQUARE iBAS/BASIC QiD 
edit: square ♦BAS 

00010 LET X-=-l 

00020 PRINT X»SQR<X) 

00030 LET X==-"X+1 

00040 IF XO-5 GO TO 20 

00050 END 

* 
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The setting of the BASIC option will turn off the S option of the End, 

Go, or World command and the UNSEQUENCE option; even if you set the 

UNSEQUENCE option, SOS will ignore it when you back up your BASIC 
file. 

Restrictions: 

You cannot set the BASIC option with the use of your SWITCH.INI option 
file or at SOS command level. 

If you edit a BASIC program file without specifying the BASIC option, 
the S option of the End, Go, or World command will execute properly, 
but you will receive the error message: ? INTERNAL CONFUSION. You 
will be returned immediately to TOPS-10 command level and your saved 
BASIC file will be renamed to nnnSOS.TEM. This temporary file must 
then be renamed to your original BASIC file specification. (Refer to 
Chapter 10, How SOS Handles Files And Buffers, for an explanation and 
examples of temporary files.) 

If your BASIC program file becomes unsequenced for some unknown 
reason, SOS will reply with the following error message when you 
attempt to edit your file with the BASIC option set: 

.SOS SQUARE fBAS/BASICOrr) 

edit: square ♦bas 

TBsd "BASIC" file format 



To solve this problem, start the SOS session without setting the BASIC 
option, so that SOS will assign new line numbers to your file. 



CAUTION 

Using SOS to edit BASIC files can bring 
about some unpredictable results due to 
the setting of other SOS options. 
Therefore, it is recommended that you 
use the BASIC program, not the SOS 
program, to edit BASIC program files. 
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BIG 



4.4.3 BIG 




Settable: 


Not Applicable 


Printable: 


Yes 




=BI[G] 


Default: 


None 


Reverse: 


Not Applicable 


Function: 





The BIG option prints the largest page number in the file being 
edited. This page number represents the total number of physical 
pages in your file during an SOS session. 

Example: 



8 
* 

The largest page number within the current file is 8. 

Restrictions: Not Applicable 
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Settable: 


Yes 




/C6[4] 


Printable: 


Yes 




=CASE 


Default: 


On 


Reverse: 


By set 


Function: 





=CASE (via the CASE option) 



By setting the C128 option 



The C64 option makes SOS consider the single quote as a normal 
character of text. When SOS has the C64 option set, you may type any 
character from your terminal, but you are not permitted to use the 
special C128 representation that is available for some characters. 
(Refer to Chapters 6 and 7 for a detailed description of special 
characters. ) 



Example: 



♦ SOS SAMPLEi. TXT/C128/liPY/M37GiD 
EDirt SAMPLE ♦TXT 

*^^'CASfc": (JtT) 

Display Model 37 Upper 

*/C64 (J^J 

*-=^=CASE CmD 

L'lisplay Model 37 C6A Upper 

* 



Restrictions: 



The only time you must set the C64 option is to reverse the C128 
option previously set; i.e., when you no longer need to enter certain 
special characters into your file. 
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4.4.5 C128 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/CI [28] 

Yes 

=CASE (via the CASE option) 

Off 

By setting the C64 option 



The C128 option gives you a means of entering certain special 
characters, namely control characters and ESCape, into your file. 
(Refer to Section 6.4 and Section 7.2 for additional information on 
special characters and the use of the C128 option.) 

To represent a special character, type an apostrophe (single quote 

character) followed by a punctuation mark or numeric character that 

represents the special character you want. If you need an apostrophe, 

type two apostrophes in succession. For example, to enter a CTRL/C 

into your file, set the C128 option, then type in '# (quote, pound 
sign) . 



Example : 



.SOS SAMPLE* TXT C^D 
EDIT? SAMPLE * TXT 

*/C;i28 CiD 

00050 '# QiD 
^/C6A ( RET ) 

00050 "X 



Restrictions: 



If your terminal is unable to input or print lowercase characters, you 
can set both the UPPER option and the C128 option to input lowercase 
characters into your file. Each desired lowercase character must be 
preceded by a single quote character. When your file is typed on your 
terminal, it will appear as all uppercase, but when printed on the 
line printer, your file will appear as desired. 

Depending on the above restriction and your terminal type (see Chapter 
6) and how you set your terminal's parameters, all desired uppercase 
characters can be entered into your file with the LOWER and C128 
options set. All desired uppercase characters must then be preceded 
by the single quote character. 
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CASE 




4.4.6 CASE 




Settable: 


Not Applicable 


Printable: 


Yes 
=CA[SE] 


Default: 


C64 Upper 


Reverse: 


Not Applicable 


Function: 





The CASE option is only printable. It reports the type of terminal 
you have and the status of the following options: 



Option 

C64 

C128 

DPY 

M33 

M37 

SEPARATORS 

NONSEPARATORS 

LOWER 

UPPER 



Message Printed When Option Is Set: 

C64 

blank 

Display 

blank 

Model 37 

Separators 

blank 

Lower 

Upper 



Example: The options C128, M37, DPY, and LOWER are set: 
LUspla':* Model S7 Lower 
The options C64, SEPARATORS, M33, and UPPER are set: 



C64 SEPARATORS UPPER 



Restrictions: Not Applicable 
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DECIDE 



4.4.7 DECIDE 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 

/DEC [IDE] 

Yes 
=DEC[IDE] 

Off 

By setting the NODECIDE option 



The DECIDE option permits you to decide whether each substitution 
should be made when using the Substitute command. The DECIDE option 
has a built-in list of DECIDE commands that allow you to make a choice 
of substitutions. The DECIDE option is the same as if you had 
specified the D option of the Substitute command. 

When you edit a file using the Substitute command with the DECIDE 
option set, SOS prints the line contents as if the substitution was 
made and then waits for one of five possible responses from you: 

Character Meaning - Result 

SPACE bar To accept this substitution. 

DELETE key To reject this substitution. 

A To enter Alter mode immediately for that line only. 

E To return immediately to SOS command mode without 

making this or any further substitutions. 

G To make this and all subsequent substitutions 

automatically. 

Q To quit now. The only substitutions that are made 

are those that were confirmed by previous 
substitutions. 

With these responses of the DECIDE option, you can control all 
substitutions made during an SOS session. 
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Example: 

♦sos/decide number* for gid 
edit: number* for 
*stipe*type*":* qed 

QED c tsc ) 

00010 TYPE 101 

G 

00020 101 FORMAT (' PLEASE TYPE A NUMBER*') 

00050 TYPE 103rX 

00060 103 FORMAT (' YOU TYPED THE NUMBER 'fF) 

00080 TYPE lOArXfY 

*==DECIDE GID 
AUTO DECIDE 
* 

Restrictions: 

If you do not set this option it remains off. 

If you press any other character than one of the five allowable ones, 
SOS prints a question mark (?) , sounds the bell on your terminal, and 
waits for another response. 

The A response of the DECIDE option causes you to enter Alter mode 
immediately. The A response of the D option of the Substitute command 
causes you to make the substitution first and then enter Alter mode. 
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DELETE 



4.4.8 DELETE 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/DEL[ETE] 

Yes 
=DEL[ETE] 

Off 

By setting the NODELETE option. 



The DELETE option, if set, will cause SOS to delete both your input 
file to the SOS session and your output file from the SOS session when 
you issue an End, Go, or World command. This option may be useful 
when you want to recreate a file while in an SOS session, using the 
same file specifications. 

The DELETE option is the same as the D option of the End, Go, and 
World commands. 



Example: 



♦ SOS F--RINT»CMDC^iD 
edit: F'RINTtCMD 

00100 F""/"?*/* 

* /delete: QID 

*-=DELET£ (J^ 

INPUT FILE WILL BE DELETED* 

input: DSKCJ print »CMDr27y 5107:] 

00100 p/it/)KCltr) 

00200 * 

t 

» /NODELETE C^iT) 

^ E ( KfT ) 

LDSKC : PRINT ♦ CMDL'27 y 5107 J !] 



Restrictions: 

It is recommended that you retain some backup copies of your files 
(using different file specifications) if you use this option because 
all files with the filnam specification will be deleted regardless of 
the file extension. 

If you do not use this option, it will always remain off, and your 
input and output files will not be deleted. 
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DISK 



4.4.9 DISK 

Settable: 
Printable: 

Default: 
Reverse: 
Function: 



Not Applicable 

Yes 

=DI[SK] or =DS[K] 

None 

Not Applicable 



The DISK or DSK option prints only your current disk quota in the 
format of: 

"nnnn" disk blocks in your area on "dev" 
"nnnnnn" blocks for all users on this structure 

Where: 

nnnn refers to the total number of blocks that you are 
allowed to use. This is the number of blocks assigned 
to your directory. A block consists of 128 words. 
Each word consists of 36 bits. 

dev is the structure (disk) that the output file is being 
written to. 

nnnnn is the total number of blocks that reside on the 
structure for all users that have access to that 
structure. 



Example: 



.sos sample* txt gid 

edit: sample.TXT 

*=:-DiSK QnD 

B460 disk blocks in v^our area on DSKC 

146740 blocks for all users on this structure 



Restrictions: Not Applicable 
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DPY 



4.4.10 DPY 

Settable: Yes 

/DP[Y] 

Printable: Yes 

=CASE (via the CASE option) 

Default: Off 

Reverse: By setting the M33 option 

Function: 

The DPY option tells SOS that you have a VT05-type terminal. It gives 
your VT05 terminal the following characteristics that other terminals 
may or may not have: 

1. CTRL/R ("R) does not echo itself when it reprints the line 
contents. 

2. CTRL/U ("u) does not echo itself when you reenter the 
contents of a line. 

3. Pressing the line feed key to print the next line causes that 
line to print over the asterisk prompt character. This 
allows you to display 20 lines on your terminal screen, thus 
eliminating double spacing. 

4. Pressing the ESCape key to print the previous line causes 
that line to print over the asterisk prompt character. This 
too, allows you to display 20 lines on your terminal screen, 
thus eliminating double spacing. 

Example: 



♦ SOB SAMF'LE»TXT/DPYQir) 
edit: sample* TXT 

DISPLAY C64 UPPER 

* ( " ) 

00100 THIS IS LINE 00100 

00100 THIS IS A TEST 

(ctrl/r) 



THIS IS A TEST C«!lJ 

* CUD 

00200 THIS IS LINE 00200 

* C ES( ) 

00100 THIS IS A TEST 
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NOTE 



The example above will appear in 
slightly different form on a VT05 with 
the DPY option set as this example was 
performed on a hard-copy terminal for 
printed example purposes. 



Restrictions: 



The DPY option will have an effect even when you are using other 
terminal types. SOS will send special VT05 characters to the terminal 
which may produce unpredictable results. 

If you specify the M33 or M37 option for SOS and then press the ESCape 
key to print the previous line, that line will print over the asterisk 
prompt character as if you had set the DPY option. 



4-20 



USING SOS OPTIONS 



ERROR 



4.4.11 ERROR 

Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Not Applicable 

Yes 
=ER[ROR] 

None 

Not Applicable 



The ERROR option prints the last error message that occurred on your 
terminal in its long-form format, even if the EXPERT option is in 
effect. 

Example: 

♦ SOS NUMBEFs' * fOR Cl^FP ) 

edit: number ♦ for 

^■ = ERROR C^^ 

^/EKFERJ (jrr) 

00900 END 

*'CID 

%Nl..N 

^^^^^ERRORQeT) 

No <j>uch lirie(s) 

Restrictions: 

As shown in the example above, if you use this option before any error 
occurs, SOS replies only with the Edit mode prompt (*) , because there 
was no previous error. 
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EXPERT 



4.4.12 EXPERT 
Settable: 

Printable: 
Default: 
Reverse: 
Function: 



Yes 

/EX [PERT] 

Not Applicable 

Off 

By setting the NOVICE option 



The EXPERT option, when used, puts you into 
Expert mode gives short abbreviated er 
characters or less. (Refer to Appendix E fo 
mode error messages.) When you use the 
commands. Expert mode does not echo on the 
numbers deleted, and does not print the opt 
OK? (Y OR N) when deleting the contents of a 
mode, the D and R instructions do not show 
the backslash characters do not appear on yo 

Example: 



the Expert mode of SOS. 
ror messages using five 
r the abbreviated Expert 
Delete and Replace SOS 
terminal the line/page 
ion message MASSIVE DELETE 
n entire page. In Alter 
the characters deleted and 
ur terminal. 



^30S/EXF'E:RT number > for C^iT) 

edit: number ♦for 

00010 TIPE 101 

*Rio GID 

00010 fTXT) 
*D/lQir) 

%NL.N 



TYPE 101 GsD 



The error message NLN, No Such Line(s), occurred because 
contents of page 1 was deleted with the D/1 command. 

Restrictions: Not Applicable 



the entire 
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INCREMENT 



4.4.13 INCREMENT 



Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/IN[CREMENT1 :n 

Yes 
=IN[CREMENT] 

00100 

Not Applicbale 



The INCREMENT option permits you to specify the numeric value, n, as 
the increment for the line numbers you are inserting into a file. If 
you do not use the INCREMENT option, the default value is 100. That 
is, each inserted line has a line number 100 greater than the previous 
line number inserted. If you are creating a new file, the increment 
value also becomes the first line number if the START option is not 
set. 



The INCREMENT option value is the default value 
commands when you do not specify an increment 
increment preceded with a comma (,) in an Inser 
this increment will become the INCREMENT option 
for further Insert and Replace commands. If yo 
preceded with a semi-colon (;) in an Insert o 
increment does not change the INCREMENT option 
of the Insert or Replace command is an 
command . 



for Insert and Replace 

If you do specify an 

t or Replace command, 

value and will be used 
u specify an increment 
r Replace command, this 
value. The ; increment 
increment for only that 



You can 
Example 



use any numeric value for the increment from 1 to 99999 



♦SOS/increment: 5 sahple*txto<^ 

input: sample ♦TXT 

THIS IS LINE OOOOSGiD 
THIS IS LINE OOOIOQED 

t 



00005 
00010 
00015 



00005 

* 1 1 IN 2 QE) 

00012 THIS IS LINE 00012 GhD 

00014 
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Restrictions: 

If you renumber your file with the Number command and do not specify a 
value, the N command will use its default of 100 with increments of 
100. If you then Insert or Replace lines at the end of your file, the 
INCREMENT option value will take effect again. 
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ISAVE 



4.4.14 ISAVE 

Settable: Yes 

/IS [AVE] :n 

Printable: Yes 

=IS[AVE] 

Default: Off (zero or none) 

Reverse: Not Applicable 

Function: 

The ISAVE option permits you to create a backup copy of the file being 
edited or created after a specified number, n, of new lines have been 
inserted. The number specified may be any value from 1 to 99999. The 
ISAVE option automatically creates a backup copy as if you had issued 
a World command. 

The ISAVE option, when printed, displays the number of insertions 
remaining before the next Auto-Save. 

Example: 



INPUT J SaRTtALG 

00100 BEGIN CreD 

00200 F\'EAL Xr YJ QTT) 

00300 WRITE <'C2C3 TYF'E THE UALUE OF XI CBJ" ) J O^ 

t: DOING AUTO-SAVEy F'LEASE WAIT* 3 

CDSKC:saRT*ALG3 

00400 READ ( X ) ? C ket ) 

00500 Y :-saRT<X) ? GiD 

00600 WRITE CLCJ THE SQUARE^'OOT DP ' ) ; GED 
EDGING AUTO-BAl^E» F'LEASE WAIT* 3 

CDSKC : SORT ♦ ALGi;;27 r 5107 3 3 
00700 PRINT ( X y 3 y 3 ) ? C siO 

00800 WRITE <• IS " ) y QID 

00900 PRINT (Yy3y3)yQ^ 

[: DOING AUTG-SA>v^Ey PLEASE WAIT* 3 

rDSKC:S«RT*ALG[:27y5107 3 3 

01000 END QiD 

01100 



* -a SAME GiiD 
* 
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Restrictions: 

If you give the World command before an Auto-Save is done, the ISAVE 
value is reset to the value specified when you had set this option. 

If you set the UNSEQUENCE option and the ISAVE option, Auto-Save will 
not unsequence your file when it is backed up and a warning message 
will be displayed on your terminal. 



4-26 



USING SOS OPTIONS 



LENGTH 



4.4.15 LENGTH 
Settable; 

Printable: 

Default: 
Reverse: 
Function: 



Yes 

/LEiNGTH] :nn 

Yes 

=LE[NGTH] 

55 

Not Applicable 



The LENGTH option is used to set the page length of printed output. 
Its default value is 55. This 55 refers to lines of text and does not 
include page headers, page numbers, or the spacing required. 



Example: 



»SOS SAMPLE* TXT GiD 
edit: sample. TXT 
»-=LENCfrH riF70 



Restrictions: 

The LENGTH option can be used only when the Justification command has 
been assembled for SOS. That is, this option has no meaning without 
the previous use of the JC, JL, JR, JU, or JW command, and changing 
its default value will have no effect during an SOS session. 
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LMAR 




4.4.16 LMAR 




Settable: 


Yes 
/LM[AR] :n 


Printable: 


Yes 
=LM[AR] 


Default: 


1 


Reverse: 


Not Appli 


Function: 





The LMAR option is used to set the Left Margin of a printed page of 
output. Its default value is 1. 

Example: 

.SOS SAMPLE ♦TXT GlD 

edit; sample ♦TXT 

>»c^H...MAR GED 

.1. 

>K 

Restrictions: 

The LMAR option can be used only when the Justification command has 
been assembled for SOS. That is, this option has no meaning without 
the previous use of the JC, JL, JR, JU, or JW command, and changing 
its default value will have no effect during an SOS session. 
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LOCATION 



4.4.17 LOCATION 

Settable: Not Applicable 

Printable: Yes 

=LOC[ATION] 

Default: None 

Reverse: Not Applicable 

Function: 

The LOCATION option is printable only. It reports the current 
position at the beginning of the SOS buffer file. You can back up 
(save) the file, using the World command, from the position indicated 
by the LOCATION option to the current position being edited. 

Example: 

»SOS SQRT*AL(3 QeT) 

edit: SQRTtALG 

)KA4 00:500 ( K" ) 

00400 READ <X)r 

t 

X ( TAB ) ( KfcT ) 

OOSOO Y :== SQRKX) ? 

t 

I ( TAB )C«ET~) 

)K-locationGID 

00100/1 

I. DSKC : BQRT » ALG Z 27 f 5 107 .] 3 
* 

The file from line 100 on page one to the last line on the last page 
has now been saved. (Refer to Chapter 10 for a description of the SOS 
buffer files.) 

Restrictions: Not Applicable 
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LOWER 



4.4.18 LOWER 



Settable: 



Printable: 



Default: 

Reverse: 

Function: 

The LOWER optio 
into a file, 
appear as upper 
printed on the 
uppercase-lower 
(LC) with the 
terminal permit 
pressing the 
characters, whe 
on the terminal 
format. 



Yes 
/LOW[ER] 

Yes 

=CASE (via the CASE option) 

Off 

By setting the UPPER option 



n permits you to enter lowercase alphabetic characters 

If your terminal is uppercase only, the characters 

case characters. However, when the characters are 

line printer, the characters appear lowercase. With an 

case terminal, you may set your terminal to LOWERCASE 

TOPS-10 command SET TTY LC. The uppercase-lowercase 

s you to enter uppercase and lowercase characters by 

SHIFT key as you would with a typewriter. The 

n entered, appear as desired and when printed or typed 

or line printer, the characters appear in their proper 



You can use the C128 option with the LOWER option to enter uppercase 
and lowercase characters during a single SOS session. With the C128 
and LOWER set, all uppercase characters must be preceded with a single 
quote character ( ' ) . 

If your terminal is set to UPPERCASE (UC) and you set the LOWER 
option, all characters will be uppercase and will appear as uppercase 
during the SOS session. 



Example: 



(using a VT05 terminal) 



♦ SET TTY UC GhD 
♦SOS TEST ♦MEM CED 

input: TEST ♦mem 

00100 $ 
f 

* =--CASE C^2> 
C6A UPPER 
)K/LOWER 
*I100( 



00100 ABCriEFGHIJKLMNOPaRSTUVWXYZ 
00200 * 
t 

*EB C«D 

CDSKCtTEST^MEMJ 

♦ TYPE TEST ♦ MEM (jIT) 

00100 ABCHEFGHIJKLMNOPQRSTUVWXYZ 
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The example above illustrates the LOWER option set using a VT05 
terminal. The VT05 terminal cannot print in lowercase. When this 
file is printed on a line printer, it will appear in its correct 
format. 

If you set your terminal to UC (uppercase) , the M33 option is 
automatically set for you when you start SOS. If you set your 
terminal to LC (lowercase) , the M33 option can only be set at Edit 
mode, since M37 is the default for lowercase terminal characteristics. 

(Refer to Chapter 6 for additional information about entering 
lowercase characters into a file.) 

Example: (using a LA36 terminal) 

,SET TTY UC GnD 
»SOS TEST»MEM C^^ 
Edit: TEST* MEM 

^./lowerGID 

*-=CASE QID 

C64 Lower 

*R100 QID 

00 100 ABCDEFGHIJKLMNOPaRSTU>^WXYZQir) 

afp , (^£) 

00100 ABCDEFGH I JKLMNOPQRSTUVWX YZ 

*EB CUD 

[idskc* test ♦rfienrit;27r5107I! J 

»TYPE TEST* MEM O^ 

00100 sbcdef ^hi Jklmnoparstuvwxye 



A text line of all lowercase characters has been entered into the file 
TEST. MEM. With an uppercase-lowercase terminal set to uppercase, the 
line appears as uppercase during the SOS session, but when typed on 
the terminal or printed on the line printer, the text appears as 
lowercase. 

Example: 

♦SET TTY LC QiD 
» s c) s t e ^> t * in e in QeT) 
Edit: TEST. MEM 
t-case C BET ) 
Model 37 C64 Upper 
* 3.200 OhD 

00200 this line is all lowercase* 

t 

(JED 

*eb CmT) 

[:dskc : test ♦ fnemi::27 f 5107 11 

t y p £■> t e s t ♦ m e m ( ret ) 
00100 abcdef <3hi Jklmnoparstuvwxyz 
00200 this line is all lowercase 

* 

With an uppercase-lowercase terminal, such as a VT52, the LOWER option 
is not needed as the terminal can be set to lowercase. This setting 
will follow through for any program that you initiate while you are 
logged-in. 
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Restrictions: 

The LOWER option can be set only at SOS command level and not in your 
SWITCH.INI file or with any SOS command. 



4-32 



USING SOS OPTIONS 



M33 



4.4.19 M33 




Settable: 


Yes 




/M33 


Printable: 


Yes 




=CASE 


Default: 


On 


Reverse: 


By se 


Function: 





(via the CASE option) 



By setting the M37 option 



The M33 option sets normal terminal parameters, indicating that your 
terminal does not have lowercase alphabetic characters. When the M33 
option is used with the C128 option, your terminal will not print 
lowercase characters and the C128 special-character convention will 
print instead. (Refer to Chapter 6, for more detailed information of 
this option when used with the C128, LOWER, and UPPER options.) 

Example: (using a VT05 terminal) 

^StlT TTY UC C^D 

♦ SaS/M33/C12a ALF'HA»M3;'5 GID 

inf'Ut: alpha »M33 

00100 * 

f 

GE) 
*:-CASi;:: cEhD 

UPPER 

JK/LOWER GiD 

5KI100 QeT) 

00100 'THIS IS AN 'M33 OPTION EXAMPLE * 

t: ' D ' s ' K ' c : ' A ' L ' P ' H ' A ♦ ' M33::i 
*/UPPER QED 

>I<F' * ( RET ) 

00100 T'H'I'S 'I'S 'A'N M33 MJ'P'T'I'O'N 'E ' X ' A 'M 'P 'L 'E ♦ 
* 

This line when printed on the line printer would appear as: 

This is an M33 option example. 

Restrictions: 

If you set your terminal to uppercase (UC) , the M33 option is 
automatically set for you when you start an SOS session. 

If you set your terminal to lowercase (LC) , the M33 option is ignored 
if it is set with the SOS command, but it prevails if set in Edit mode 
after the SOS session has started. 
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4.4.20 M37 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/M37 

Yes 

=CASE (via the CASE option) 

Off 

By setting the M33 option 



The M37 option permits you to type and print lowercase alphabetic 
characters on your terminal. This option is dependent upon the type 
of terminal you are using to enter text in an SOS session. (Refer to 
Chapter 6, Typing Uppercase and Lowercase, for more detailed 
information on inputing uppercase and lowercase and your terminal 
type.) 

On an uppercase-only terminal (one that will accept only uppercase 
characters) , the M37 option will have no effect if set by itself and 
all alphabetic characters will type and print in uppercase only. 

If you have an uppercase-only terminal and you set the C128 option 
when the M37 option is already on, you should also set either the 
UPPER or LOWER option depending on which is more convenient for you, 
and then use the C128 conventions for entering uppercase and lowercase 
text. 

On a VT05-type terminal, the M37 option, when set, allows lowercase 
alphabetic characters to be entered as text. The characters appear as 
uppercase on the terminal screen, but when printed on the line 
printer, the characters appear lowercase. 

Example: (using a VT05 terminal) 

.SET TTY LCCUD 
, SOS ALPHA ♦M37CiD 
input: alpha. M37 

00100 THIS IS AN M37 AND UPPER OPTION EXAMPLE 
00200 ON A VT05 TERMINAL SET TO LC* 

t 

GED 

*=CASE C^TT) 

MODEL 37 C64 UPPER 
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In the above example, you enter text by pressing the SHIFT key for 
uppercase as you would with a typewriter. The entire text appears as 
uppercase on your terminal screen, but when printed on the line 
printer, the test appears as follows: 

*P100J200 OTT) 

00100 This is an M37 and UPPER option example 

00200 on a VT05 terminal set to LC* 

« 

Restrictions: 

If you set your terminal to lowercase (LC) , the M37 option is set 
automatically for you when you start an SOS session. 

If you set your terminal to uppercase (UC) , the M33 option is in 

effect and the M37 option is ignored even if set with the SOS command, 

but the M37 option can be set in Edit mode after starting the SOS 
program. 
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MAXLN 



4.4.21 MAXLN 



Settable: 



Yes 

/MA[XLN] rnnnnn 



Printable: Yes 

=MA[XLN] 



Default: 
Reverse: 
Function: 



99999 



Not Applicable 



The MAXLN option permits you to set the maximum line number (nnnnn) 
for input to a page of text within your file. After you have created 
the line whose number is the value of the MAXLN option, SOS 
automatically switches from Input mode to Edit mode. 



Example: 



♦ S0S/MAXLN:300 LINELMXTQiD 
input: line ♦TXT 
OOiOO THIS IS LINE 
00200 THIS IS LINE 
00300 THIS IS LINE 300 QeD 

* =-=;MAXLN CHID 
00300 



100 QE) 
200 



Restrictions: 

When you have reached the MAXLN value, you must either create a new 
page or reset the MAXLN option. The value of the MAXLN option cannot 
be greater than 99999. 

When you use the Copy and Transfer commands, the lines copied or 
transferred may exceed the MAXLN value. You should then renumber (N 
command) your file, specifying a smaller increment for the line 
numbers. 
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NAME 



4.4.22 NAME 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 

/NA[ME] :dev:f ilnam.ext [p,pn,sfdl, . . . ] <nnn> 

Yes 
=NA[ME] 

None 

Not Applicable 



The NAME option permits you to change the full output file 
specification while at SOS command level. (Refer to Chapter 2, Giving 
Commands, for a complete description of full file specifications.) 

Example: 



»SOS SAMPLE, TXT CiS 
E'dit: SAMPLE- .TXT 

* /NAME : SORT . ALG GE) 
*=-'NAME (HD 
DSKC:SQRT,ALG 

* E GeD 

C; DSKC t SQRJ ♦ ALGC 27 » 5 1 07 IIJ 



The output file specification was changed during Edit mode. 

Restrictions: 

The NAME option can not be set in your SWITCH.INI file or with the SOS 
command at TOPS-10 command level, but only at the SOS command level. 
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NOBAK 



4.4.23 NOBAK 



Settable: 


Yes 




/NOB[AK] 


Printable: 


Yes 




=BAK 


Default: 


Off 


Reverse: 


By setti 


Function: 





The NOBAK option permits you to suppress the Qxt file extension backup 
copy of a file when you give the End, Go, or World command. When you 
suppress the Qxt backup copy, the NOBAK option forces SOS to create a 
new source of the file being edited. 

Example: 

»SOS/NOBAK SAMPLE* TXT QsD 

Edit: SAMPLE* TXT 

*"BAK ( "ET ) 

No backup file will be created 

* 

Restrictions: 

If the OLD option is set with the NOBAK option, the OLD option will 
override the NOBAK option and backup files will be created. 
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NODECIDE 



4.4.24 NODECIDE 



Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/NODEC[IDE] 

Yes 
=DEC[IDE] 

On 

By setting the DECIDE option 



The NODECIDE option permits you to suppress the DECIDE option for 
Substitute commands. By SOS default, this option is active when 
creating or editing a file. 

Example: 

.SOS NUMBEFwFOR QtD 

edit: numecr»fgr 

*-Di;;:ciDi;:: QiD 

NO AUTO DE-CIDE 

*/ DEC IDE CEO 

AUTO DECIDE 
Restrictions: Not Applicable 
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NODELETE 



4.4.25 NODELETE 



Settable: 

Printable; 

Default: 
Reverse: 
Function: 



Yes 
/NODEL[ETE] 

Yes 
=DEL[ETE] 

On 

By setting the DELETE option, 



The NODELETE option is the SOS program default. The only time you 
must set the NODELETE option is when the DELETE option has been 
previously set to delete both the input file to an SOS session and the 
output file from an SOS session. The NODELETE option does not allow 
the deletion of your input file(s) when you issue the End, Go, or 
World command to save your file(s). 



Example: 



♦ SOS sample; t txt/dele:te r^TD 

edit: sample ♦TXT 

*=riELETE GED 

INPUT FILE WILL BE DELETED* 

♦/NODELETE C^T) 

*=-DELETE CslT) 

INPUT FILE WILL NOT BE DELETED* 

* 



Restrictions: Not Applicable 
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NONSEPARATORS 



4.4.26 NONSEPARATORS 



Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 

/NONS [EPARATORS] 

Yes 

=CASE (via the CASE option) 

On 

By setting the SEPARATORS option 



The NONSEPARATORS option, when used, tells the SOS program that the 
period (.), the dollar sign ($) , and the percent sign (%) characters 
are not punctuation marks and are alphanumerics (A through Z, 
through 9) . The NONSEPARATORS option is active by default when 
creating or editing a file. In Alter mode with this option, the W and 
X instructions treat these three characters as part of the word being 
skipped or replaced. 



Example: 



♦SOS NONSEP.£XPCIiD 
Edit: NONSEP»EXP 

*Aioo GiD 

00100 THE DOLLAR *IGN IS PART OF THE WORD -*IGN* 



t 

S$ 



t 



t 

s* 



t t 

w GID 



00200 
* 



WITH THE /NONSEPARATORS OPTION IN EFFECT* 



Restrictions: Not Applicable 
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NONUMBER 



4.4.27 NONUMBER 



Settable: 

Printable: 
Default: 
Reverse: 
Function: 



Yes 
/NONU[MBER] 

Not Applicable 

Off 

By setting the NUMBER option 



The NONUMBER option permits you to suppress line-number printing on 
the terminal when you create or edit a file. This option is 
particularly useful when editing files that contain long lines for 
full-page printed output. 

The NONUMBER option is useful when editing extremely large files with 
increments of 1 that would contain Wrap Around. With a file this 
large, you can use the command formats of the Line Contents 
Specifications command to edit your file, thus avoiding line numbers. 

If you wish to use the standard SOS command format to create or edit 
your file, the NONUMBER option will allow SOS to use its default of 
00100 with increments of 100, but the line numbers will not print. 
You may change the 100 default by using the Number command at SOS 
command level; the file will be renumbered, but the line numbers will 
still not print when specified with any SOS command as long as the 
NONUMBER option is set. 

Example: 



♦ S0S/N0NUMBE:R TESr^MtlKQiD 

Editt TEST»MEM 

*P100 CEE^ 

THIS IS LINE ONE 

*p*Two$ C«r) 
(JED (JED 

J* FIVE* (JE) 

CED 

THIS IS LINE TWO 
THIS IS LINE THREE 
THIS IS LINE FOUR 
THIS IS LINE FIVE 
*N1 CED 
*P9 (JED 

THIS IS LINE NINE 
* 



4-42 



uSxi^iG SOS OPTIONS 

The example above illustrates editing a file with the NONUMBER option 
set and using the Line Contents Specifications Print command format. 
(Refer to Chapter 8, Line Contents Specifications, for a description 
of this method of editing files.) 

Restrictions: 

If you specify any other options that pertain to line numbers, such as 
INCREMENT or START, SOS will ignore these options if the NONUMBER 
option with the SOS command is in effect. 

When you save your file after an SOS session using the NONUMBER 
option, SOS will save the file with line numbers unless you specify 
the S option of the End, Go, or World command, or set the UNSEQUENCE 
option. 
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NOVICE 



4.4.28 NOVICE 
Settable: 

Printable: 
Default: 
Reverse: 
Function: 



Yes 

/NOV [ICE] 

Not Applicable 

On 

By setting the EXPERT option 



The NOVICE option is the SOS program default. The only time you must 
set the NOVICE option is to change the setting from EXPERT. With the 
NOVICE option, error messages are printed in full on your terminal and 
the MASSIVE DELETE OK? message is displayed when you delete a large 
range of line numbers. With the Delete and Replace commands, the line 
number/page number (s) are echoed on the terminal. With the D and R 
instructions of the Alter mode, the deleted characters are echoed on 
your terminal enclosed in back-slashes. 

Example: 

♦ sos/expe-:rt number »f or qit) 

Edit: NUMBER* FOR 

*R10 G^D 

00010 TYPE 101 QiD 

*/NOVICEQiD 
»R»/lO?ir) 

00090 ENDGID 

1 Lines <00090/l) deleted 

Restrictions: Not Applicable 
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4.4.29 NUMBER 
Settable: 

Printable: 
Default: 
Reverse: 
Function: 



Yes 
/NU[MBER] 

Not Applicable 

On 

By setting the NONUMBER option 



The NUMBER option is the SOS program default. The only time you must 
set the NUMBER option is to change from the NONUMBER option. The 
NUMBER option allows line numbers to print while you are creating or 
editing a file. 



Example: 



input: sahple*txt 

THIS IS A NONUMBER OPTION EXAMPLE THAT WILLGED 
CHANGE TO THE NUMBER OPTION** 

^/NUMBER C^D 

*p QIT) 

00100 THIS IS A NONUMBER OPTION EXAMPLE THAT WILL 

00200 CHANGE TO THE NUMBER OPTION* 

^il ( RET ) 

[.DSKC: SAMPLE* TXT :3 



Restrictions: 

If you edit a file with the NONUMBER option set and during the SOS 
session you set the NUMBER option, SOS assigns the original line 
numbers to your file. The INCREMENT and START options used before the 
NUMBER option will have had no effect. 
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4.4.30 OLD 



Settable: 


Yes 
/OL[D] 


Printable: 


Not Applicable 


Default: 


Off 


Reverse: 


Not Applicable 


Function: 





The OLD option permits you to create a Zxt file-extension backup-copy 
of the file being edited. If a Zxt backup-copy already exists, no new 
Zxt file will be created and the present Zxt file will remain 
unchanged. The OLD option does not suppress the Qxt file-extension 
backup-copy of an edited file, except on the first edit of a file. 

Example: 



♦ DIRECTCID 



numbef;; for 



<05 



2-fe:b-78 



DSKC J 



C27fS:l073 



Total of 4 blocks in .t files on DSKC J l.27r51071 

♦ SOS/OLD NUMBER ♦ F"OR CrkT) 
Edit: NUMBER* FOR 

*R10GED 

00010 TYPE 101 GID 

1 Lines (00010/1) deleted 

♦ EQID 
[:DSKC:NUMBER»F"0Rt:27r5107JJ 



flURECTQET) 

NUMBER FOR 
NUMBER ZOR 



<055: 
<0S5: 



2-FEB-78 
2~FEB-78 



DSKC J 



C27»51073 



Total of 8 blocks in 2 files on DSKC: L27f51073 



Restrictions: 

If the Zxt file extension already exists in your directory area, 
setting the OLD option will not create a new Zxt backup copy. 

If you set the OLD option with the NOBAK option, the OLD option will 
override the NOBAK option. Thus, backup files will be created. 
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4.4.31 OPTION 
Settable: 

Printable: 
Default: 
Reverse: 
Function: 



Yes 

/OP[TION] :pointer-name 

Not Applicable 

None 

Not Applicable 



The OPTION option permits you to set a list of option (s) identified in 
your SWITCH, INI file by "pointer-name". If, for example, you have a 
line in your SWITCH.INI file: 

♦TYPE SWITCH.INI QID 

00100 S0S:DEF/M37/EXPERT/N0NUMBER/SEPARAT0RS 

* 

where DEF is the pointer-name of the list of options, then you can set 
these options with the OPTION option by specifying DEF as the 
"pointer-name" in the /OPTION command. DEF is the pointer-name in 
your SWITCH.INI file that^has, in this example, the options DPY, M37, 
EXPERT, NONUMBER, and SEPARATORS assigned to it. (Refer to Section 
4.2.3 for additional information about the Set option command and 
pointer-names. ) 



Example: 



♦SOS NUMBER ♦ FOR GED 
Edit: NUMBER .FOR 

♦./option: DEF GED 

*=CASE CE£) 

D i s F' 1 a '^ Model 37 C64 Separators Upper 

*.p QlD 

TYPE 101 

101 FORMAT <' PLEASE TYPE A NUMBER.') 
ACCEPT 102 »X 

102 FORMAT (F) 
TYPE 103 fX 

103 FORMAT (' YOU TYPED THE NUMBER '»F) 
Y = 2 * X 

TYPE lOAfXrY 

FORMAT <' TWICE 'yFf' IS 'rF) 

END 



104 



Restrictions: 

If you specify a pointer-name that does not identify a list of options 
in your SWITCH.INI file, the error message ? OPTION NOT FOUND will be 
displayed on your terminal. 

If you have misspelled an option within the list of options, the error 
message ? SYNTAX ERROR IN OPTION FILE will be displayed on your 
terminal. 
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4.4.32 Period (.) 

Settable: Not Applicable 

Printable: Yes 

line number/page number 

Default: None 

Reverse: Not Applicable 

Function: 

The Period option prints the current position in the file. The 
position consists of the line number and page number. 

Example: 

!<< = ♦ rSiT) 
00700/3 

The current position within the file is line number 700 on page 3. 
Restrictions: Not Applicable 
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4.4.33 PLINES 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/PL[INES] :n 

Yes 
=PL[INES] 

16 

Not Applicable 



The PLINES option permits you to change the number of lines that print 
on your terminal when you give the Print command. The n argument can 
be any value from 1 to 99999. The SOS default value for this option 
is 16 lines. 



Example: 



♦ SC)S/PL I NES : 3 SQRT ♦ ALG GID 

edit: SQRT ♦ALG 

>KP QeT) 

00100 BEGIN 

00200 REAL Xr Y5 

00300 WRITE <"C2C3 TYPE THE VALUE OF XJ CBl')i 

*=PLINESG£D 

3 

* 



Restrictions: Not Applicable 
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4.4.34 PMAR 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/PM[AR] :n 

Yes 
=PM[AR] 



Not Applicable 



The PMAR option is used to set the first line indentation of a 
paragraph. Its default value is 1. The n can have a value from to 
the width of the text. 

Example: 



♦SOS SAMPLE ♦TXT GH 
Edit: SAMPLE ♦TXT 
*^=PMAF\' QTr) 
1 



Restrictions: 

The PMAR option can be used only when the Justification command has 
been assembled for SOS. That is, this option has no meaning without 
the previous use of the JC, JL, JR, JU, or JW command, and changing 
its default value will have no effect during an SOS session. 
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4.4.35 READONLY 

Settable: Yes 

/R[EADONLY] 

Printable: Not Applicable 

Default: Off 

Reverse: Not Applicable 

Function: 

The READONLY option permits you to make NO updates to a file. When 
you use this option, you can only read the file; you can use only the 
following SOS commands: 

1. Alter (A) (the E, L, P, S, and W Alter instructions only) 

2. Find (F) 

3. List (L) 

4. Print (P) 

SOS ignores the World command if the READONLY option is in effect; it 
accepts the End command as if you had issued an EQ command. All other 
SOS commands receive only the error message: %ILLEGAL COMMAND. 



Example: 



♦ sos/f<eadonl y sosrei-f ♦ rno ge) 
read: sosref*rno 

* 113500 QiD 

% ILLEGAL COMMAND 
t.R200 CED 

% ILLEGAL COMMAND 
*C3000 ? 7500 : 8000 GED 

% ILLEGAL COMMAND 

*F-'3000 GID 

03000 DIGITALW* 
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Restrictions: 

You cannot remove this option during an SOS session; you must end the 
session and start SOS again without this option. 

If you place the READONLY option in your SWITCH.INI file, the error 
message ? SYNTAX ERROR IN DEFAULT OPTIONS will appear when you start 
an SOS session. If the READONLY option is included in a list of 
options identified by a pointer-name, the error message ? SYNTAX ERROR 
IN OPTION FILE will appear when you issue the /OPTION:pointer-name 
command. Therefore, the READONLY option can only be set with the SOS 
command at TOPS-10 command level. 
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4.4.36 RNAR 



Settable: 


Yes 
/RM[AR] :nn 


Printable: 


Yes 
=RM[AR] 


Default: 


69 


Reverse: 


Not Applicable 


Function: 





The RMAR option is used to set the Right Margin of a printed page of 
output. Its default value is 69. The value of n is dependent on the 
desired width of the text. 

Example: 

,.SOS SAMPLE ♦TXT QID 
edit: sample ♦TXT 
*=-:RMAR GlD 
69 

Restrictions: 

The RMAR option can be used only when the Justification command has 
been assembled for SOS. That is, this option has no meaning without 
the previous use of the JC, JL, JR, JU, or JW command, and changing 
its default value will have no effect during an SOS session. 
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4.4.37 RUN 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 

/RU [N] :dev:prograin-name.ext [p,pn,sfdl, . . . ] 

Yes 
=RU[N] 



SYS:COMPIL 



Not Applicable 



The RUN option permits you to specify the program to be run when you 
end an SOS session with the Go command. The "dev" , if not specified, 
is SYS. The "program-name" can be up to six alphanumeric characters 
and can be any executable TOPS-10 program. The ".ext", if not 
specified, defaults to .EXE. The " [p,pn,sfdl . . . ] " is the directory 
path. (Refer to Chapter 2, Giving Commands, for a complete 
description of full file specifications.) 



Example: 



♦ SOS NUMBER. FOR C«iD 

Edit; NUMBER.FOR 

*=RUN QiD 

SYS:COMPIL 

*/RUN: SYS J FORTRA.EXE G^ 

*STIPE*TYF'E$'"J*rN CED 

t t 

QsT) ( ts( ) 
*=RUN QeT) 
SYS : FORTRA.EXE 

♦GCEsD 

t DSKC: NUMBER ♦F0RI:27t 5107 J 1 

FORTRAN; NUMBER 

MAIN. 

link; Loading 

CLNKXCT NUMBER Execution 3 

PLEASE TYPE A NUMBER. 

45 

YOU TYPED THE NUMBER 45.0000000 

TWICE 45.0000000 IS 90.0000000 

END OF EXECUTION 

CPU time: 0.12 ELAPSED TIME: 4.00 

EXIT 



Restrictions: Not Applicable 
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4.4.38 SAVE 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/SA[VE] :n 

Yes 
=SA[VE] 

Off (zero or none) 

Not Applicable 



The SAVE option permits you to automatically back up the file being 
edited after the specified number, n, of SOS commands. The number 
that you specify may be any value from 1 to 99999. The backup takes 
place automatically without your having to leave the SOS session. 
This option works in the same way as the World command. 

The SAVE option, when printed, displays the number of editing SOS 
commands that must be given before an Auto-Save is performed. (The 
ISAVE option, in contrast, specifies the number of lines that must be 
inserted before an Auto-Save.) 



Example: 



♦ SOS/SAME.: 3 alf-'HA»f;;no==note*rno GiD 

edit: NOTEtRNO 

*R100 QiD 

00100 a_C)WER CASE,FLAG CAPITALIZE Q^TT^ 

1 LINES (00100/1) DELETED 

>KA500 G[D 

00500 BECAUSE ALL CHARACTERS ARE MADE 

i 



t 

2SR 

1 

*X60o GiD 

00600 .END NOTE QiD 

C DOING AUTO-SAVE > PLEASE WAIT .3 

C DSKC: ALPHA ♦RN0C27r 51073 3 

*::=SAyE GID 

3 



CID IS QEDQi 



Restrictions: 

If you give the World command before an Auto-Save is done, the SAVE 
value is reset to the value specified when you had set this option; 
that is, the full value of the SAVE option is needed before the next 
Auto-Save occurs. 

If you set the UNSEQUENCE option and the SAVE option, Auto-Save will 
not unsequence your file when it is backed up, and a warning message 
is displayed on your terminal. 
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4.4.39 SEPARATORS 

Settable: Yes 

/SEP[ARATORS] 

Printable: Yes 

=CASE (via the CASE option) 

Default: Off 

Reverse: By setting the NONSEPARATORS option 

Function: 

The SEPARATORS option, when used, tells SOS that the period (.), the 
dollar sign ($) , and the percent sign (%) are not alphanumerics and 
are punctuation marks. The SEPARATORS option is of particular use 
when creating or editing COBOL, FORTRAN, and MACRO source program 
files because you may use these three characters as part of the 
program language. In Alter mode with this option, the W and X 
instructions treat these three characters as separators and not part 
of the word being skipped or replaced. 

Example: 

♦ SOS/SEIPARATORS NONSEP . EXPQE) 
edit: NONSEP* EXP 

♦Aioo:20o GiD 

00100 THE DOLLAR *IGN IB NOT PART OF THE WORD •*IGN- 
t ft t t tt t 

s* WW w inotCZD CjED s* wwGID 

00200 WITH THE WNONWSEPARATORS OPTION IN EFFECT* 

t t 

SN 3D OHT) 

Restrictions: Not Applicable 
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4.4.40 SEQUENCE 

Settable; Yes 

/SEQfUENCE] 

Printable: Yes 

=SEQ[UENCE] 

Default: On 

Reverse: By setting the UNSEQUENCE option 

Function: 

The SEQUENCE option is the SOS default option; it leaves the line 
numbers in the output file when the SOS session ends. You only have 
to set this option when you have previously set the UNSEQUENCE option 
to remove line numbers. 



Example: 



. sob/unsequence note * rnoqid 
edit: note»rng 

»= SEQUENCE r^TT) 

MO SEQUENCE NUME<EFi;S WILL BE ON OUTPUT FILE 

»/S£QUENCEC^^ 

*=^SEOUENCE QTT) 

SEQUENCE NUMBERS WILL BE ON OUTPUT FILE 

* 



Restrictions: Not Applicable 
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4.4.41 START 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 
/STA[RT] :n 

Yes 
=STA[RT] 

100 

Not Applicable 



The START option permits you to change the value of the starting line 
number from its default value of 100. The value may be from 1 to 
99999. The START option by itself only indicates the number of the 
first line; all subsequent lines default to an increment of 100 plus 
the START value. 



Example: 



» SOS TEXT » TXT/START : 5 QiD 
input: text t TXT 

00005 THIS IS A START OPTION EXAMPLE* Ci^FT) 
OOIOS THE SECOND LINE IS 100 PLUS THE /START VALUE ^GED 
00205 EACH LINE IS INCREMENTED BY THE DEFAULT OF 100, QiD 
00305 $ 
t 

CUD 

*-START riHT 
5 



Restrictions: 

When the START option is used for editing a file, that file must 
been unsequenced prior to the SOS session. 



have 



TO have line numbers increment with the same value as the START 
option, set the INCREMENT or STEP option with the same value as the 
START option when you start the SOS session. 
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4.4.42 STEP 




Settable: 


Yes 




/STE[P] :n 


Printable: 


Yes 




=STE[P] 


Default: 


100 


Reverse: 


Not Applicable 


Function: 





The STEP option is similar to the INCREMENT option and can be used by 
itself to indicate the starting line number and each subsequent line 
number increment within a file. You may use the STEP option to change 
the SOS default. The numeric value that must be specified with the 
STEP option may be from 1 to 99999. 



Example: 



♦ SOS cobol»cbl/step:3QID 

INPUT? COBOL ♦CBL 

00003 ID DIVISION* GiD 

00006 AUTHOR* USER-ID* CZlD 

00009 DATA DIVISION* QID 

00012 WORKING" STORAGE SECTION* CIlI 

00015 



JU 



(lESl) 

X(=STEPCEID 
00003 

*=INCREMENTGiD 
00100 

* 

Restrictions: 

The Insert and Replace commands cannot change the value of the STEP 
option, but they can change the INCREMENT option. 
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4.4.43 STRING 

Settable: Not Applicable 



Printable: 

Default: 
Reverse: 
Function: 



Yes 
=STR[ING] 

None 

Not Applicable 



The STRING option is printable only. It permits you to check the 
current default of a Find or Substitute command. The STRING option 
also prints the range contents used when you are editing a file by 
line-contents specifications. (Refer to Chapter 8, Line Contents 
Specifications, for a description of range specifications and the 
STRING option.) 

Example: 



»SOS NUMBER* FOR QlD 

edit: number ♦for 

*FTIF'E| QiD 

00010 TIPE 101 

*STIPE*TYF>E*GID 
t t 

C^D ( Est ) 

00010 TYPE 101 

*=STRING GiD 

find: 

TIPE 

substitute: 

TYPE 

for: 

TIPE 

line-contents: 
i: 



3: 

*SQe7) 

00020 

00050 

00060 

00080 



101 FORMAT (' please TYPE A NUMBER*') 

TYPE 103rX 
103 FORMAT (' YOU TYPED THE NUMBER 'fF) 

TYPE 104rXrY 



Restrictions: Not Applicable 
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4.4.44 UNSEQUENCE 

Settable: Yes 

/UN [SEQUENCE] 

Printable: Yes 

=SEQ[UENCE] 

Default: Off 

Reverse: By setting the SEQUENCE option 

Function: 

The UNSEQUENCE option permits you to remove line numbers from the 
output file when ending an SOS session. The UNSEQUENCE option 
performs the same function as the S option of the End, Go, or World 
command. In fact, you may use the S option of the End, Go, or World 
command to unsequence your saved output file to avoid the use of the 
UNSEQUENCE option. 

Example: 

♦ SOG TEXT* TXT Q^ 

edit: text ♦TXT 

*=^SEQUENCE CeD 

SEQUENCE NUMBERS WILL BE ON OUTPUT FILE 

*/UNBEQUENCEQrT3 

♦.= SEQUENCE QID 

NO SEQUENCE NUMBERS WILL BE ON OUTPUT FILE 

Restrictions: 

If you set the UNSEQUENCE option and then give the WS command during 
an SOS session, the following error message will appear: 

♦ SOS/UNSEQUENCE TEXT ♦ TXT (^D 
Edit: TEXT ♦TXT 

*WS ( KH ) 

[; WARN I N G t S e < -i u e n c e N i j in b e r s I"' r* e s e r^ v e d 11 
CLiSKC:TEXT*TXT[:27y5107:]1 



This error message indicates that both your current file and your 
backup file will contain line numbers. 

If you give the ES command with the UNSEQUENCE option set, your 
current file is unsequenced, but your backup file (Qxt or Zxt) will 
contain line numbers. 



4-61 



USING SOS OPTIONS 



UPPER 



4.4.45 UPPER 
Settable: 

Printable: 

Default: 
Reverse: 
Function: 



Yes 

/UP [PER] 

Yes 

=CASE (via the CASE option) 

On 

By setting the LOWER option 



The UPPER option is the SOS program default for the alphabetic 
character representation. With either an uppercase-only terminal or 
an uppercase-lowercase terminal, all alphabetic characters appear as 
uppercase when typed. To enter lowercase characters into a file with 
the UPPER option set, you must specify the C128 option and precede 
each lowercase character with a single quote character ('). 

(Refer to Chapter 6 for additional information about entering 
uppercase characters into a file.) 



Example: 



»SOS SAMPLE- ♦TXT QlD 
edit: sample- ♦ TXT 
*-CASEGID 
C64 UPFEf: 

If- I ( ^ KtT } 

000^50 THIS IS AN UPPEFv'CASE EXAMPLE ♦QeT) 

* F'' ♦ ( ^ KH 3 

00050 THIS IS AN UPPERCASE EXAMPLE* 

*/C128ChD 

•^ * C "ET } 

00075 T'H'I'S 'I'S LOWERCASE 'W'I'T'H UPPER 
' ' P ' f ' I ' ' N C^D 

*/C64QID 
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Two lines are inserted at the beginning of SAMPLE.TXT. 

♦ SET TTY LCCEE) 

♦ type sample ♦txt Cj^Ll) 

00050 THIS IS AN UPPERCASE EXAMPLE* 
00075 This is LOWERCASE with UPPER option 



♦ set tty uc ( RET ) 

♦TYPE SAMPLE ♦ TXT GiD 

00050 THIS IS AN UPPERCASE EXAMPLE* 

00075 This is LOWERCASE with UPPER option 

♦♦♦♦♦♦♦♦♦♦ 

The TOPS-10 command SET TTY LC or SET TTY UC affects only the input 
characters. This command does not affect output if your terminal will 
print lowercase characters. 

Restrictions; Not Applicable 



4-63 



USING SOS OPTIONS 



4-64 



CHAPTER 5 
SOS COMMAND DESCRIPTIONS 



5-1 



SOS COMMAND DESCRIPTIONS 
SOS COMMAND DESCRIPTIONS 



Chapter 5 contains descriptions of all the SOS Commands for 
the TOPS-10 SOS program. The SOS Commands are in 
alphabetical order, each starting on a right hand page for 
easy reference. 

There are eleven possible headings in each description; 
these headings are listed and explained in the following 
text: 

Function Contains one or two sentences briefly 

describing what the command does. 

Format Describes the syntax of the command 

its command name, arguments, and 
options. 

Arguments Describes the attributes or values that 

must be supplied with the command. 

Options Describes the attributes or values that 

are optional. Commands that have 
optional values may also have default 
values. 

Hints Outlines convenient functions the 

command can perform and references other 
commands you might use along with the 
one being described. 

Restrictions Describes the limitations and 

peculiarities of the command. Also 
explains common error messages you may 
receive while giving the command. 

Special Cases Describes specifically how the command 

operates in certain special cases. 

Instructions Describes the function and syntax of 

each subcommand which you may give. 

Characteristics Describes special extended 

characteristics, features, or formats of 
the command. 

Operation Lists instructions describing how to 

give the command, with an example of a 
typical command. 

Examples Shows a few common ways to give the 

command. In examples, anything you type 

appears in red print, anything the 
system types appears in black. 
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(lD 



5.1 QlD- linefeed command 

Function 

The Linefeed command has three functions: 

1. In Edit mode, the Linefeed command prints the next line in 
the file. 

2. With the I instruction in Alter mode. Linefeed creates a new 
line. (Refer to the description of the Alter command.) 

3. With the extend command. Linefeed creates a new line. (Refer 
to Section 5.27 for the description of the extend command.) 

Format 



Restrictions 

If you are located at the last line of your file and give the 
Linefeed command, SOS prints the message: 

%N0 SUCH LINE(S) 

and returns to Edit mode. You may then give any SOS command. 

Examples 

1. You print the next line in a file after line number 04550. 

*P4550 QE) 

04550 THIS IS LINE NUHBER 04550. 

*CiD 

04560 IN EDIT MODEr <LF> PRINTS THE NEXT LINE* 
* 

2. You try to print the next line, but you are already positioned at 
the last line of the file. 

%N0 SUCH LINE(S) 
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3. You alter line 300 by pressing the LINEFEED key after the S 
instruction of Alter mode to create a new line. 

* P300 QeT) 

00300 THIS IS AN ALTER EXAMPLE* 

*A300 GTT) 

00300 THIS IS AN ALTER 

t 1 

srCjD CZ3 

00350 EXAMPLE* 

t 



5-4 



SOS COMMAND DESCRIPTIONS 




5.2 CiD- ESCAPE COMMAND 
Function 

The ESCape command has five functions: 

1. In Edit mode when you press ESCape as the only input for a 
line, the previous line prints. 

2. In Input mode when you press ESCape, Input mode terminates. 
(Refer to the description of the Insert and Replace commands. 
Sections 5.12 and 5.21.) 

3. In Alter mode when you press ESCape, the string you are 
inserting after an Alter mode I, R, or X instruction 
terminates. (Refer to the description of the Alter command. 
Section 5.3.) 

4. In Edit mode with the Find and Substitute commands, ESCape 
terminates the existing-str ing and/or the new-string. (Refer 
to the descriptions of the Find and Substitute commands. 
Sections 5.7 and 5.23.) 

5. In Edit mode with the extend command, ESCape ends the line 
extension and starts Alter mode. (Refer to the description 
of the extend command. Section 5.27.) 

Format 

* ( Est ) 

Restrictions 

If you press the ESCape key when you are at the first line of 
your file, your terminal prints the message: 

%N0 SUCH LINE(S) 

You may give another command; no change has occurred. 
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Examples 

1. You press the ESCape key to print the previous line. 

05600 THE <ESC> COMMAND PRINTS THE PREVIOUS LINE* 
* 

2. You use the Find command to locate the text string "WORDS" in 
lines 100 through 800. The ESCape key indicates the end of the 
existing-str ing. 

*FUORLiS$ 1 00 : 800 (JtT) 
t 

( fcSC~) 

00600 ESCAPE ENDS THE STRING CALLED "WORDS'* 
* 
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5.3 . - MOVE COMMAND 
Function 

The . (Move) command moves your current position in the file but 
does not print the line. 

Format 

♦.position 

Argument 

position indicates the line to which you want to move the 
pointer. The position can take the form of either 
line/page number or line contents. 

Hints 

The Print command performs the same function, but also prints the 
line. 

The Period option only prints your current position in the file. 

Restrictions 

If you indicate a nonexistent line, SOS prints the message: 

%N0 SUCH LINE(S) 

then prints an asterisk. Find a nearby line and reissue the 
command. 

If you indicate a nonexistent page, SOS prints the message: 

%N0 SUCH PAGE 

then prints an asterisk. Choose the correct page and reissue the 
command. 
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Examples 

1. You make the current position line 900 on page 4. 

*»900/4 QiD 
* 

2. You make the current position the first line on the first page. 

3. You attempt to position on the first line of the last page, but 
the last page does not contain any lines. 

%No such lineCs) 
* 

4. By using line contents specifications, you move your position to 
a line in your file that contains the words MOVE TO HERE. (Refer 
to Chapter 8, Line Contents Specifications, for a complete 
description of how to issue SOS commands in this format.) 

C tst ) ( fcsc ) 

*»*MOVE TO HERE*/lGrr) 
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5.4 / - SET COMMAND 

Function 

The / (Set) command sets an SOS option. Chapter 4 contains a 
complete description of all the SOS options. Appendix B contains 
a list of them. 

Format 

*/option-name rvalue ( ret ) 
Argument 

option-name is the name of the option that is settable. 

Option 

rvalue is the option value. Some options do not take a 
value, because they are either on or off, as 
switches are. 



Hints 



Many options can be preceded by the prefix NO to counteract their 
operation. 



Restrictions 



If you give a nonexistent option name or misspell an option name, 
SOS prints the message: 

% ILLEGAL COMMAND 

followed by an asterisk. You should find the correct option name 
and format from Appendix B and reissue the command. 
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Examples 

1. You set the increment value to 50. 

♦/INCREMENT I 50 GiD 
t 

2. You try to set the SEPARATORS option, but misspell it. 
*/SEPERATORS C^^ 



% ILLEGAL COMMAND 

»/SEPARAT0RSC»O 
* 

3. You set all the options as specified by the pointer-name MODE in 
your SWITCH.INI option file. 

*/OPTIONtMODE QID 
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5.5 = - GIVE COMMAND 

Function 

The = (Give) command prints the value or setting of any printable 
option, (Refer to Appendix B, Summary of SOS Options, to find 
which options are printable.) 

Format 

*=opt ion-name C"rf~) 
Argument 

option-name is the name of an option that is printable. 

Restrictions 

If you type a nonexistent name or mistype a name, SOS prints: 

% ILLEGAL COMMAND 
* 

Refer to Appendix B, Summary of SOS Options, and/or reissue the 
command. 

Examples 

1. You may request your current terminal settings by typing the 
=CASE command. 

*=--^CASE-: GiD 

MODEL 37 C64 SEPARATORS UPPER 
* 

2. If you get an error message when the EXPERT option is in effect 
and you want a fuller message, type the =ERROR option, and the 
error message will be printed in full. 

%ORDER 
*=ERROR GE) 
%OUT OF ORDER 
* 

3. You want to know the current position of the pointer during an 
SOS session. The period (=.) option prints the pointer's current 
line number/page number. 



♦ — * ( RtT ) 

01300/2 
* 
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5.6 @ - INDIRECT COMMAND 

Function 

The @ (Indirect) command takes commands from a file rather than 
from your terminal. When SOS reaches the end of the file, it 
prints the message: 

%INDIRECT EOF 

or %CMEND if the /EXPERT option is set. 

Format 

*(gf ilespec C Kti ) 

Argument 

filespec is the file specification of the file containing 
the indirect commands. This argument can be 
specified as a full file specification as follows: 

dev:f ilnam.ext [p,pn,sfdl , . . . ] <nnn> 

(Refer to Chapter 2, Giving Commands, for a 
complete description of full file specifications 
and additional information on indirect command 
files and their use.) 



Hints 



Output from the indirect commands will print on your terminal 
unless you suppress it by using: 

1. The S option of the Print and extend commands 

2. The N option of the Find and Substitute commands 

All error messages occurring from the execution of an indirect 
command will appear on your terminal. 

If the indirect file contains a Substitute command with the D 
(Decide) option, you must respond to the decide prompt from your 
terminal, rather than from within the indirect file. (Refer to 
Example Number 2.) 
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Restrictions 

If a command in the indirect file is illegal, SOS prints the 
standard error message, %ILLEGAL COMMAND, plus another message 
indicating the incorrect -command. You can not give an indirect 
command from an indirect file; that is, you can not nest 
indirect files. If you try to, SOS prints the message: 

% ILLEGAL COMMAND 
COMMAND # OOOOn 

where n is its position in the indirect file, SOS will then 
continue to process the next command in the indirect command 
file, if another command exists. 

If there is an error reading the command file, SOS prints the 
following message and terminates taking commands from the file: 

7ERR0R READING INDIRECT FILE 

Examples 

1. You take commands from the indirect command file COMNDl.CMD which 
contains commands to print line 100, print line 200, and delete 
line 300. 

00100 PlOO 
00200 P200 
00300 D300 

Note that SOS reprints the last message after giving the 
%INDIRECT EOF message. 

*(?C0MND1,CMD QiD 

00100 THIS IS THE FIRST LINE OP TEXT 
00200 THIS IS THE SECOND LINE OF TEXT 
1 Lines (00300/1) deleted 

/^Indirect EOF 

1 Lines (00300/1) deleted 

* 

2. You edit a text file TEXT.RNO that contains the word "may" where 
the word "can" should be. The indirect command file SUB.CMD 
contains one line S may '= can '=":*,D (created in C128 mode) 
which causes SOS to substitute and decide on each substitution. 
The following example shows the results of executing SUB.CMD 
while in the Edit mode for the TEXT.RNO file. 

*(?SUB*CMi:i (J^ 

00250 You can Print lines with sn indirect file* 



00540 The file e.xtension can be omitted when you 



00550 crefite an indirect file* You csn 
% Indirect EOF 
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3. You edit a file with the indirect file COM.CMD, which appears as: 

00100 PlOO 
00200 B200 
00300 P300 

Line 00200 contains an illegal command, B200 instead of P200. 

*(?COM.CMliG[r) 

00100 THIS IS THE FIRST LINE OF TEXT 

%Ille«lal cojTimand 
COMMAND * 00002 

*00300 THIS IS THE THIRD LINE OF TEXT 

%Iridirect EOF 
* 

SOS indicates that the second command in the indirect file is 
illegal and continues to process the indirect command file. 
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5.7 ALTER - A COMMAND 

Function 

The Alter command starts Alter mode, which allows you to edit a 
line or lines without having to retype the unchanged portion. 
Alter mode has its own instructions which do not echo on your 
terminal . 



Format 

♦ArangeQED 
Argument 

range specifies the range of lines you want to alter. 



Hint 



To abort an Alter command, give the Alter mode Q instruction 
which restores the current line and returns to Edit mode. 

Restrictions 

When using the Alter C, I, R, and X instructions, the BACKSPACE 
key, used as a way to delete characters, will echo back a CTRL/H 
("H) for each backspaced character in the line being altered. 

If you specify an invalid range or lines that do not exist, SOS 
responds with the error message: %N0 SUCH LINE(S). If you press 
any character or key that is not described in this section, the 
bell will sound on your terminal, because that character or key 
is invalid in Alter mode. 

Alter Mode Instructions 

After you give the Alter command, your terminal prints the number 

of the first line you want to alter. Give any one of the 

following Alter mode instructions which operate in the following 
way: 

1. The instructions themselves do not print on your terminal as 
do Edit mode commands; however, changes you make to the line 
do print. 

2. While editing each line, the pointer of your terminal always 
points to your current position in the line. When counting 
characters, always consider the position of this pointer to 
be in FRONT of the character it is pointing to. 

After you alter the first line, continue to alter lines until you 
reach the end of the range you gave in the initial Alter command. 
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If you type any character that is not an Alter mode instruction, 
your terminal will sound the bell (CTRL/G) . 

In the descriptions of the Alter mode instructions, the following 
symbols are used: 



Symbol 



Meaning 



chrs 



(underscore) Indicates the position of the pointer 
(that is, the carriage or cursor on your terminal) 
BEFORE you give the instruction. 

Represents an integer number which, if omitted, 
defaults to 1. The n is used to make an instruction 
operate on the next n characters. 

(minus sign) Indicates that the particular instruction 
can work either forward or backward from the present 
position. When you use the minus sign (-) , the 
instruction operates on the last (or previous) n 
characters; otherwise, without the minus sign (-) , the 
instruction operates on the next n characters. 



Shows where you can type a 
format of an instruction. 



single character in the 



Shows where you can type more than one character in the 
format of an instruction. 
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Alter Mode Instructions 



Format Function 

CUD When you press RETURN, SOS prints the rest of the 

line, then ends Alter mode for the current line. 
You can then alter the next line (if one exists) 
in the range given with the A command. 

Pointer: After the instruction, the pointer is at 
the beginning of the next line. (You 
may still be in Alter mode or you may be 
in Edit mode, depending on the range of 
the Alter command.) 

*A 900077) 

00900 THE RETURN KEY ENDS ALTER MODE* 



t 

C^iD 



n ( sp ) Advances the pointer n characters to the right. 

(Remember to count the character currently being 
pointed to.) 

Pointer: After the instruction, the pointer is in 
front of the nth character. 

*A500 QiD 

00500 TO MOVE AHEAD r PRESS THE SPACE BAR 



t t t 
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Alter Mode Instructions 

Format Function 

hQeT) Moves the pointer back n characters. In moving 

the pointer, your terminal prints a single 
backslash (\) , then the letters that are passed 
over. When you give the next Alter mode 
instruction, your terminal prints a second 
backslash. If you try to move past the beginning 
of the line, your terminal reprints the line 
number, giving you a fresh line to work on. This 
instruction does not delete the characters that it 
passes over. 

On a VT05 terminal, the RUBOUT key will operate in 
the same way as the DELETE key. 

Pointer: After the instruction, the pointer is in 
front of the nth character to the left. 

*P200CEiD 

00200 THE DELETL" INSTf^■UCTION MOVES LEFT. 

♦ A200CreD 

00200 THE DELETE INSTRUCTION MOVES\SEVOM\MOVES LEFT* 

t t f 

2 SS riQ ?5 QE)C«hD 



( TAB ) Moves the pointer to the end of the line, printing 

- ( TAB ) the characters it passes over. When preceded by a 

minus sign, the TAB instruction moves the pointer 
backward to the beginning of the line, but this 
time your terminal encloses the characters in 
backslashes, prints them in reverse order, and 
starts a new print line. 

Pointer: After a TAB instruction, the pointer is 
after the last character in the line. 
After a -TAB instruction, the pointer is 
in front of the first character in the 
line. 

Jf' A 3 3 b ( Rr-T ) 

00335 MINUS TAB COMMANDXDNAMMOC BAT SUNIMX 
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Alter Mode Instructions 



Format 



Function 



Cancels any changes you have made to the current 
line, then restores the current line so you can 
start your changes again. 

Pointer: After the instruction, the pointer is in 
front of the first character on the 
current line. 

♦ Pl^OOQtTD 

OOSOO CTRL/U INSTRUCTION RESTORES THE LINE* 

♦ASOOQID 

00500 CTRL/U WINSTRUCTIONW RESTORES THE LINE»"U 



t 



t 

tin 



t 

( TAB ) 



t 



00500 



CTRL/U INSTRUCTION RESTORES THE LINE* 



t 

CUD 



nCchrs 



Deletes the next n characters (n is an integer), 
then lets you insert up to (and including) n new 
characters in their place. 



Your terminal 
characters, 
you may use th 
SOS will print 
backslashes, 
must type it 
at the end 
instruction, 
is, insert 
instruction, 
new character 
instead of the 



does not print the deleted 

If you type an incorrect character, 

e DELETE or RUBOUT key to back up. 

the incorrect character enclosed in 

To retype the correct character, you 

twice. If the pointer is initially 

of the line, SOS ignores the 

You may not create new lines (that 

Linefeeds) with the Alter C 

If you want to insert less than n 

s, use the Alter R instruction 

C instruction. 



Pointer: After the instruction, the pointer is 
after the last character you inserted. 

*P4500C«iD 

04500 THE C INSTRRCTIGN CHANGES TEST* 

*A4500Qir) 

04500 THE C INSTR IMNUCTIGN CHANGES TEXT* 



t 

2SR 



t 



UU2 



* 



Note that in this example, the 2SR searches for 
the second R in INSTRRCTION. By mistyping an I 
instead of an U, you must press DELETE and type U 
twice to put it in the line. The 2SS after the U 
insertion searches for the S in TEST. This S is 
changed to X. 
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Alter Mode Instructions 
Format Function 



nD Deletes the next n characters; if you include the 

-nD minus sign, it deletes the previous n characters. 

Your terminal prints two backslashes and the 
deleted characters. When you give the next Alter 
mode instruction, your terminal prints a second 
set of backslashes to enclose the deleted 
characters in backslashes. 

If you set the EXPERT option, your terminal does 
not print the deleted characters. If the pointer 
is at the end of the line when the instruction is 
given, the instruction is ignored unless it 
includes the minus sign. 

Pointer: After the instruction, the pointer is 
after the last character you deleted. 
If you use the minus sign, the pointer 
is before the last character you 
deleted. 

*P1500CElD 

01500 THE D INSTRUCTION DELE^TES CHARACTERS. 

♦A.QkT) 

01500 THE D WINSTRUCTION W 





t t t 




s;r i2i:i e 


*P.( RH~) 




01500 


THE D DELETES CHARACTERS. 


* 





Note that in this example, 11 letters and the 
blank following the word are deleted; this helps 
maintain correct spacing in the line. 



Ends Alter mode for this line without printing the 
rest of the line. 

>icP600CZiD 

00600 THE E INSTRUCTION ENDS ALTER. 

*A. CrtT) 

00600 THE E INSTRUCTION 



t t f f 

WWW E 
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Alter Mode Instructions 

Format Function 

inclchrs ( esc ) Inserts characters, starting at the present 
position and continuing until you press ESCape. 
If you mistype any characters in the insertion, 
you can use the DELETE or RUBOUT key to correct 
the incorrect character insertion. If more than 
497 characters are on the line (not including 
deleted characters) , SOS prints the message 
%LINE TOO LONG and restores the line as it was 
before you entered Alter mode. 

New Lines: 

To insert a new line containing the 
characters from the present position to 
the end of the current line, press 
LINEFEED. The pointer is now before the 
first character of the new line. If you 
placed an increment before the I 
instruction (that is, inc) SOS uses that 
increment in creating the new line 
number; otherwise, it uses the current 
increment. If using the given increment 
makes the new line out of order, SOS 
uses a line number halfway between the 
current line and the next line. Should 
no more lines be available, SOS prints 
the message %OUT OF ORDER, retypes the 
current line up to the current position, 
and allows you to insert more 
characters. 

Terminating : 

To end the Alter I instruction, press 
either ESCape or RETURN. ESCape 
terminates only the Alter I instruction. 
RETURN terminates both the Alter I 
instruction and Alter mode for the 
current line. 



*P6700Qi7^ 

06700 THE I INSTRUCTION CHARACTERS* 

*A» ( RET ) 

06700 THE I INSTRUCTION INSERTS CHARACTERS* 

f t 

2SC IINSERTSC^dDQiD 
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Alter Mode Instructions 



Format 



Function 



Places the rest of the line at the front of the 
next line in the file. If you are located at the 
last line in the file, SOS prints %N0 NEXT LINE 
and reprints the line up to the current position. 

00100 the j instruction brings text to 

00200 the next line. 

*aiooCmD 

00100 the j instruction 

In f 

u u y J 

00200 BRINGS TEXT TO THE NEXT LINE. 
f 



nKc 
-nKc 



Deletes all the characters in the current line 
from the present position up to (but not 
including) the nth occurrence of the character c 
just as if you had given the necessary number of 
Alter D instructions. Given with a preceding 
minus sign, the K instruction deletes backwards 
through (and including) the nth occurrence of the 
character . 



Note that the nK instruction deletes up to the nth 
occurrence of the character, while the -nK 
instruction deletes through the nth occurrence of 
the character. 



*P650ChD 

00650 the k instruction is a longer delete. 

♦ a.GeiD 

00650 the k instruction wis a longer deletew. 




t t 

THE K INSTRUCTION ♦ 



CED 



If n is not given in the format, the K instruction 
will not work and will not sound the terminal bell 
or print an error message. 



*P650 G^ 

00650 THE K INSTRUCTION IS A LONGER DELETE. 

*A. C ret) 

00650 THE K INSTRUCTION W NOITCURTSNIW 



t t 

3 SI -2KI 

* P , ( RET ) 

00650 THE K IS A LONGER DELETE. 
* 
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Alter Mode Instructions 
Format Function 



Prints the rest of the line on your terminal and 
then reprints the current line number with the 
pointer positioned before the first character. 



00100 the: l instruction F'Rints the line* 
*Aioo GID 

00100 THE L INSTRUCTION F"'RINTS THE LINE* 

t t 

SI L 
00100 



Prints the rest of the line on your terminal and 
then reprints the current line and moves to the 
current position. 

*F'iooGiD 

00750 THE P INSTRUCTION REPRINTS TO POSITION* 

*A750 QID 

00750 THE P INSTRUCTION REPRINTS TO POSITION* 

t if 

2SR P 

00750 THE P INSTRUCTION 



Restores the original contents of the current 
line, then Quits (that is, ends) Alter mode for 
the entire range. 



*P985 (heQ 

00985 THE Q INSTRUCTION QUITS ALTER MODE* 

*A985:i000 GID 

00985 THE Q \\INSTRUCTION\\ 

t t t 

SI IID Q 

*P985 GhD 
00985 THE Q INSTRUCTION QUITS ALTER MODE* 
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Alter Mode Instructions 
Format Function 



nRchrs CTsT) Deletes n characters, then gives an insert 
•nRchrsQir) instruction. The R instruction lets you insert 
(replace) as many characters as you want (up to a 
line length of 497). With a preceding minus sign, 
the R instruction deletes through the previous n 
characters, then lets you insert. The n 
characters that are deleted are enclosed in 
backslashes as with the Alter D instruction. With 
the EXPERT option set, the deleted contents and 
the backslashes do not appear on your terminal. 

The number of characters deleted and the number of 
characters inserted do not have to match (as they 
do with the C instruction) . 

Pointer: After the instruction, the pointer is 
after the last character you inserted. 

*P10.10!2 GlD 

01010 THE R COMMAND DELETE- S N CHARACTERS 

01020 THEN PERMITS INSERTION* 

*A1010 QID 

01010 THE R WCOMMANDWINSTRUCTION 

f f f 

sc 7r instruct i on ctit) e 

*/expi;::rt gID 

*A1020 QtT) 

01020 THEN PERMITS ALLOWS INSERTION* 

f f f' 

W W -8RALL0WS CUGEDGiD 
*P1010!2 GeT) 

01010 THE R INSTRUCTION DELETES N CHARACTERS 
01020 THEN ALLOWS INSERTION* 
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Alter Mode Instructions 



Format Function 



nSc Searches for the nth occurrence of the character 

-nSc specified by c. If no n is specified, the 

occurrence defaults to the first occurrence of the 
character c. If the minus sign is included before 
the number or the S, the S instruction searches 
for the last occurrence of the character specified 
by c moving from right to left on the current 
line. 

If the character c cannot be found, the pointer 
moves to the end of the line and waits for another 
Alter instruction. If you have an 
uppercase-lowercase terminal and your text 
contains both uppercase and lowercase characters, 
you must use the SHIFT key with the S command when 
searching for uppercase characters. 

Pointer: After the instruction, the pointer is at 
the character specified, but the 
character itself is not printed on the 
terminal. When the minus sign is used 
and the instruction is completed, the 
pointer is after the character specified 
and the character is printed on the 
terminal. 

* P42'5 CsID 

00425 THE S INSTRUCTION SEARCHES FOR CHARACTERS* 

* Af ( RET ) 

0042S THE S INSTRUCTION SEARCHENEHCRAES 

t t t 

4SS -SS E 
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Alter Mode Instructions 



Format Function 

nV Inverts the case for n characters or to the end of 

the next word. This is an optional SOS Alter mode 
instruction and must be assembled for your 
installation of SOS. If the inVert case 
instruction is not assembled for your SOS 
installation, the bell will sound when you try to 
use this instruction. 

The V instruction will convert all lowercase 
characters in a word to uppercase or convert all 
uppercase characters in a word to lowercase, 
whichever happens to exist on the line being 
altered. The V instruction will operate on a 
word-by-word basis or by the number of characters 
specified by n. 

Pointer: After the V instruction has executed, 
the pointer is at the next character in 
the line being altered. 

*P1600QiD 

01600 THE V INSTRUCTION INVERTS THE CASE* 

♦ A* ( "ET ) 

01600 The V Instruction inverts the esse* 



t t 

*FM600 C RET ) 


t t f 


t t 

V ( RET ) 


01600 The V 
* 


Instruction inverts the 


C3se» 



nW Skips over n (partial or full) words, then skips 

over any blanks and tabs to position the pointer 
at the beginning of the next. word. A word is a 
string of any combination of letters and numbers 
followed by one or more spaces. Special 
characters, such as ", #, @, are words by 
themselves. The ., $, and % become words by 
themselves if the SEPARATORS option is set. 

♦ P'otiO ( RET ) 

00550 THE W INSTRUCTION SKIPS OVER WORHS* 

♦/SEPARATORS QiD 

*A, C RET ) 

00550 THE W INSTRUCTION SKIPS OVER WORDS* 

t t t t 
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Alter Mode Instructions 



Format Function 



XchrsQsT) Deletes a partial or entire word, the blanks and 

tabs that follow it, and then allows you to type 

characters which are inserted in the place of the 
deleted text. The deleted text is enclosed in 

backslashes. With the EXPERT option set, the 

contents and backslashes do not appear on your 
terminal . 

The inserted characters do not need to include a 

separator character unless you want a space 

between the characters you insert and the next 
word . 

*piii !2 GnD 

00111 THE X COMMANLi REMOVES A WORD 

00112 AND PERMITS INSERTION* 
* Alll !2 GID 

00111 THE X WCOMMAND \\ INSTRUCTION 

t t t 

SC XINSTRUCTIONCiD E. 

00112 AND WPERMITS WALLOWS INSERTION* 

t t "f 

sp XALLOWsCiDGsr) CUD 
* p 1 1 1 ! 2 CED 

00111 THE X INSTRUCTION REMOVES A WORD 

00112 AND ALLOWS INSERTION* 
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5.8 COPY - C COMMAND 

Function 

The Copy command copies a range of lines to a destination in your 
file. The Copy command does not change the original lines in any 
way. 

Special Cases 

Copying lines from another file. (Refer to Extended 
Characteristics in this section.) 

Numbering the first and last pages with a different increment. 
(Refer to the f irst-page-inc and the last-page-inc under Options 
in this section.) 

Format 

*Cdestination,soqrce-range, f irst-page-inc , last-page-inc ( ret ) 

Arguments 

destination is the line number where SOS will place the copied 
lines. 

, source-range is the range of lines you want to copy to the 
destination. 

Options 

,f irst-page-inc 

is the increment SOS uses to number the first page 
of copied lines. All lines in succeeding pages 
(except the last page) retain their line numbers. 
If the increment is too large to fit the lines in 
the destination, SOS prints either %OUT OF ORDER 
or %WRAP AROUND and chooses a smaller increment, 
printing the message: 

INCl=first page increment 

, last-page-inc 

is the increment SOS uses to number the last page 
of copied lines. If the increment is too large, 
SOS prints %OUT OF ORDER or %WRAP AROUND and 
chooses a smaller increment, printing the message: 

INC2=last page increment 
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Extended Characteristics 

The following two formats of the Copy command allow you to copy 
lines from another file into your current file being edited. 
These formats are particularly useful for creating files from 
sections of other larger files. 

Function (1) 

The following format of the Copy command copies lines from 
another file into your current file. With this format of the 
Copy command, you must know the range of lines to be copied. 

Format 

*Cdest=f ilespec , range, f irst-page-inc ,last-page-inc ( "ti ) 

Arguments 

dest is the destination (line number/page number) where 

SOS will place the copied lines. 

=filespec is the file specification of the source file from 
which you are copying the lines. The file 
specification can consist of the following: 

dev: f ilnam.ext [p,pn,sfdl , . . . ] 

(Refer to Chapter 2, Giving Commands, for a 
complete description of these file 
specifications. ) 

, range is the range of lines you are copying from the 
source file. 

Options 

,f irst-page-inc 

is the increment number SOS uses in numbering the 
first page of copied lines. 

,last-page-inc 

is the increment SOS uses in numbering the last 
page of copied lines. 

Operation 

1. Type a C and the destination; then type an equal sign (=) . 

2. Type the source file specification and a comma. 

*cioo-=te;stor,fof^, 
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3. Type the source range, a comma, and, if desired, type the 
first- and/or last-page-inc separated by a comma. Then press 
RETURN. 

* ClOO-TESTOR ♦F'GRr 100/1 :*/*y 100 » 10 GRiD 

In this example, SOS will place immediately after line 100 a 
range of lines from file TESTOR.FOR that extends from line 
100 of page 1 to the last line of the last page; it will 
renumber the first page to increment by 100, and the last 
page to increment by 10. The middle pages will be unchanged. 

Function (2) 

The following format of the Copy command allows you to look at a 
file (that is, you can give Find and Print commands) before you 
have to specify the source range and optional increments. With 
this format of the Copy command, you do not need to know in 
advance the range of lines to be copied. 

Format 

*Cdestination=f ilespec/S dnD 

Arguments 

destination is the line number where SOS will place the copied 
lines. 

=filespec is the file specification of the source file from 

which you are examining and/or copying the lines. 

The file specification can consist of the 
following : 

dev: f ilnam.ext [p,pn, sfdl , . . . ] 

(Refer to Chapter 2, Giving Commands, for a 
complete description of these file 
specifications. ) 

/S allows you to search the source file for the 

desired lines to be copied. Without the /S, this 
entire command is illegal. 

Operation 

1. Type a C, the destination, and then an equal sign (=) . 

2. Type the source file specification. 
*C100-TESTOFv'»FOFs' 
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3. Type a slash (/) , an S, and press RETURN. SOS prints the 
prompt C*. You can now give Find and Print commands to find 
the range of lines you want to copy. 

*C100--=TEST0R»F0R/S QiD 

OKFEND /I o^rr) 

00900 END 

c*FC GE) $/iGtD 

GED 

00100 C THIS IS A TEST 
C* 

4. When you are finished looking through the file, give the E 
command. SOS prints SOURCE LINES=. Type the source range, 
and if desired, the first- and/or last-page-inc separated by 
commas, and press RETURN. 

c*EGiD 

SOURCE LINES=100/i:900/lClD 
« 

If you do not want to copy lines from this file, give the EQ 
command instead of the E command. The EQ command aborts the 
copy and returns you to your current file in Edit mode, 

C*EQ QiT) 



Restrictions 



If you specify a file specification that does not exist when you 
are using either of the Extended Characteristic formats, SOS will 
reply with the error message: 

%FILE NOT FOUND 

You must then reissue the Copy command again using the filename 
and file extension of a file that does exist. 

If you issue a Copy command for a extremely large range of lines, 
you may receive the error message: 

%INSUFFICIENT CORE AVAILABLE 

Reissue the Copy command again using a smaller range of line 
numbers and repeat the Copy command until the entire range is 
copied. 

If you get either of the messages: %OUT OF ORDER or 
%WRAP AROUND, the contents of your file are intact, but the line 
numbers are not in ascending order. Renumber your file until you 
do not get either of these messages printed. 
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If your first-page-increment causes the lines to be out of order, 
SOS chooses another increment and prints its value in the 
message: 

INCl=first-page- increment 

Similarly, if your last-page-increment causes the lines to be out 
of order, SOS chooses another increment and prints its value in 
the message: 

INC 2=1 as t-page- increment 

Examples 

1. You copy lines 500 through 900 on page 2 to a destination of line 
100 on page 1, SOS provides an increment of 00010 per copied 
line. 

*C100/lf 500/2: 900/2 C«D 

INC1=00010 

* 

2. You copy the contents of three pages from SAMPLE.TXT to TEXT. TXT. 
TEXT. TXT now contains four pages instead of one, because the Copy 
command will copy the page marks of SAMPLE.TXT along with its 
contents. 

♦ SOS TEXT ♦TXT QID 
edit: text ♦TXT 

*p GK) 

00100 LINE ONE> PAGE ONE 
00200 LINE TWOr PAGE ONE 

*C300:-=SAhPLE ♦ TXT/S GE) 

c*E GiD 

SOURCE LINES=/i:/3GID 

))C= ♦ ( RET ) 

00200/4 

When you gave the = (Give) command in the above example, it 
showed that your current position in the file TEXT. TXT is line 
200 on page 4. Your file now contains four pages of text. 
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D 



5.9 DELETE - D COMMAND 

Function 

The Delete command deletes all the lines in the specified range 
and prints a message telling you which lines were deleted. 

Format 

*Drange,Y ( ret ) 



Argument 

range 



is the range of line numbers/page numbers that you want 
to delete from your file. The range may be one line, 
the entire contents of a page, or the contents spanning 
many pages. 



Options 



may be used to eliminate the SOS message: MASSIVE 
DELETE OK? (Y OR N) when you are deleting the entire 
contents of a page or multiple pages. The Y option 
simply supplies the Y response in advance. 



Special Cases 



If you give a Delete command that deletes a whole page, SOS 
prints the message: 

MASSIVE DELETE OK? (Y OR N) 

You can type Y (for Yes) or N (for No) . SOS will respond with 
the ES of YES or the O of NO. If you want SOS to assume a Yes 
answer, include the ,Y option in the Delete command. If you set 
the EXPERT option, this question is not asked and SOS does not 
print the message telling which lines it deletes. 

If the range includes a page mark, the page mark is deleted and 
all subsequent page marks are decremented by 1. Any lines left 
on the deleted page are appended to the page where the deletion 
started. When the range does not include a page mark (but does 
include a page-number), for example the command D/page-number , 
the D command deletes only the contents of the page and not the 
page mark. (Refer to Chapter 3 for a description of the page 
mark format.) 
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Also, when a page mark is deleted, any lines left on the deleted 
page are appended to the page where the deletion started. 

If appended line numbers are not in an increasing order, SOS 
prints the message: 

%OUT OF ORDER 

Give the Number command to place the line numbers back in order. 

Hints 

Use the Kill command to delete page marks without deleting any 
text. 

Restrictions 

If there are no lines to delete, SOS prints the message: 

%N0 SUCH LINES 

and prints the asterisk prompt character. 

Examples 

1. You delete all lines from line 200 to (and including) line 400 on 
the current page (page 4) . 

*r!20o: 400 QED 

3 LINES (00200/4 J00400) DELETED 
* 

2. You delete the entire contents of page 3 from your file and then 
ask for a printout of page 3. After the deletion has been 
executed, the page mark for page 3 remains but the page is blank, 

*D/3 QiD 

MASSIVE DELETE OK? (Y OR N): YES 

3 LINES (00100/3:00300) DELETED 

*p/3CItD 

PAGE 3 
* 

3. You delete from line 300 on page 2 to (and including) line 100 on 
page 4 and eliminate the MASSIVE DELETE OK? message with the Y 
option. The page mark for page 3 automatically has become the 
page mark for page 2. Because the line numbers are out of order, 
you then issue the Number command to correct the line-number 
sequence. 

*D300/2 : 100/4 y Y cltD 

%OUT OF ORDER 

5 LINES (00300/2:00100/4) DELETED 

*nGiD 
* 
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5.10 END - E COMMAND 

Function 

The End command ends the 303 session. The options give 
instructions for saving or not saving your file. 

Format 

*Em:filespec CUD 

Options 

m is a modifier that can be either B, D, Q, S, or a 

combination of B and S. 

B suppresses creation of a backup file with the 
extension Qxt; also suppresses the creation of a 
backup file with the extension Zxt if the /OLD 
option is set. 

D deletes both the original file (input to SOS) and 
your edited file (output from SOS) . 

Q quits so that all changes to the original file 
from the time of the last backup to the present 
are lost. 

S unsequences (that is, strips line numbers from) 
the output file. 

tfilespec is the file specification of the output 
(destination) file. This file specification can 
consist of the following: 

dev: f ilnam.ext [p,pn,sfdl, . . . ] <nnn> 

This argument is optional; if it is omitted, the 
current file is used. (Refer to Chapter 2, Giving 
Commands, for a complete description of these file 
specifications.) 

Hints 

To save the file without line numbers, do one of the following: 

1. Place the /UNSEQUENCE option in your SWITCH.INI file. When 
you do, the option automatically applies to every file you 
create or edit with SOS. 
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2. Include the /UNSE^UENCE option in your SOS command: 

.SOS/UNSEQUENCE filespecdD 

3. Set the /UNSEQUENCE option before you give the End command. 

4. Give the ES command. 

After the End command has saved your file, SOS prints the file 

specification enclosed in square brackets. If you have not made 

any changes to the file since it was last saved, SOS prints the 
message: 

[NO CHANGES.] 

updates the date of the file, then ends the SOS session. 



Restrictions 



If you give the ED command, SOS will delete both the input file 
and the output file. The ED command cannot have any other 
options, such as the Q, S, B, or filnam.ext. 

If you specify a file specification of another file which already 
exists in your directory when you give the End command, SOS asks 
you to confirm the deletion of this currently existing file by 
printing: 

OUTPUT FILE EXISTS - DELETE? (Y OR N) : 

To confirm the new name of your edited file and the deletion of 

the existing file, you must reply with a Y (for Yes) . You do not 

need to press RETURN after typing Y or N; SOS responds with the 

ES of YES or the of NO. If your reply is NO, SOS asks for 
another name of the file: 

FILE: 

and you must supply a new file specification. SOS then saves the 
contents of the edited file in the file you specify. 

In some conditions, the Qxt backup file may become 
write-protected . SOS ignores the write-protection, creates the 
backup file, and prints the message: 

%BACKUP FILE PROTECTED - IGNORED 

If the file is protected and you cannot overwrite it, SOS prints: 

?FILE WRITE PROTECTED, TRY ANOTHER NAME 

FILE: 

after which you should type a new file specification. 
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If you type an illegal file specification, SOS prints following 
message: 

% ILLEGAL COMMAND 
* 

Your file is not saved until you give a correct file 
specification. 

Examples 

1. To save your file the first time since creating it, you give the 
E command. 

^il ( **" ) 

[:dskc:test»alg3 



2. You save your file without line numbers 

>KES QiD 

C DSKB J CHANGE »CBLi:: 27^5107 3 3 



You end the SOS session without saving the changes you have made, 
thus restoring the file back to the last backup. (With the EQ 
command, as with the ED command, you can not specify any other 
option or a file specification.) 



You try to save your file in another directory, but you do not 
have access privileges to that directory. 

#E : SAMPLE ♦TXTC27r 2353 GID 

%ILLEGAL COMMAND 
* 

You now specify a directory that you do have access privileges 
to. 

*E : SAMPLE . TXT C 27 , 53073 CsiD 
C DSKB J SAMPLE ♦ TXTC 27 r 53073 3 
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5. You start to save your file without line numbers and without a 
Qxt backup, specifying the output file as the current file being 
edited. SOS asks for confirmation to write over this file 
without line numbers and and without creating a Qxt backup file. 

♦ EBS: TRY* FORGED 

OUTPUT FILE EXISTS - DELETE? <Y OR N): \ES 
CDSKC:TRY»F0RC27»51073D 



6. You give the End command when you have made no changes since you 
last saved the file. 

*EQED 

CNO CHANGES » 3 
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5.11 FIND - P COMMAND 

Function 

The Find command searches for the first occurrence of a string of 
characters located within a range of lines. After the characters 
are found, SOS prints the line containing them. 



Format 



*Fstring$range, A, N,E, number QeT) 



Argument 



string is the string of characters you want to find. If 
you omit the string, SOS uses the string you used 
in the last Find command. Uppercase letters match 
lowercase letters and vice versa. If you want SOS 
to find an exact match, include the ,E option 
(below) . 

$ ends the string. The string cannot exceed 200 

characters. If you omit the string and omit 

pressing ESCape, you must end the command by 
pressing RETURN. 

range specifies where SOS will search for the character 

string(s). If you press ESCape and omit the 
range, SOS searches from the current position 
through to the end of the file. If you omit the 
starting place from the range, SOS starts at the 
next line (Refer to Special Cases below.) 



Options 



,A instructs SOS to enter Alter mode after finding 

the string. The Alter mode pointer is positioned 
before the first character of the string. The ,A 
option stays in effect when you give the F$ 
command for additional occurrences of the 
specified string (refer to Special Cases) . 

,N limits the Find command to print just the line 

number of a line, eliminating the printing of its 
contents. You cannot use both the ,A and the ,N 
options at the same time. The ,N option stays in 
effect when you give a F$ command for additional 
occurrences of the specified string (refer to 
Special Cases) . 
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,E requires an exact match. Uppercase letters match 

only the corresponding uppercase letters; 
lowercase letters match only the corresponding 
lowercase letters. You must place the ,E option 
after the range, or after the ,A or ,N option if 
one is present. The ,E option stays in effect 
when you give a F$ command for additional 
occurrences of the specified string (refer to 
Special Cases) , 

, number finds that number of lines containing the string. 
You can use this option instead of repeating the 
Find command many times. The , number option does 
not stay in effect beyond the current Find 
command . 



Special Cases 



*F ( WET ) continues finding the next occurrence of the 
string specified in the last Find command, 
starting from the line after the last string found 
and proceeding to the end of the range specified 
in the last Find command. 

\ 

*F$(j£l) continues finding the next occurrence of the 

string specified in the last Find command, 

starting from the line after the last string 

found, but proceeding through to the end of the 
file. 



tring$:location QED 



*Fstring 



finds the first occurrence of the string, starting 
from the next line through to the location 
specified in the command. For example, 
*FITINERARY$: 300/4 finds the first occurrence of 
ITINERARY located between the next line and line 
300 of page 4. 
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Extended Characteristics 

*Fstr in gl jj^ J 
str ing2 ( r^t ) 
str ing3 ( rei ) 
str inq4( rh ) 

stringSC^TT) 

str ing 6$ range ,A,N,E , number ( ret 

t 



The above Find command searches for up to six strings, as long as 
the total length of the strings is not more than 200 characters. 
This form of the Find command prints the first line that matches 
any one of the strings and then stops. 

Hints 

With the Find command and the /C128 option set, you can use any 
of the Special Matching Characters. (Refer to the Substitute 
command in this chapter and/or Chapter 7, Special Characters in 
Find and Substitute Commands.) 

Restr ict ions 

If SOS cannot find the string, it prints the message: 

%SEARCH FAILS 

and does not change your location in the file. 

If the string is not located on the current page, SOS prints its 
page number before printing the line providing you have specified 
a range of more than the current page. If you did not specify a 
range of more than one page, SOS will print the above error 
message . 

If you do not specify a string and you have not previously given 
a Find command , SOS prints the message: 

%N0 STRING GIVEN 

To find out what the current string is, give the =STRING command. 

If you specify a string that exceeds 200 characters in length, 
SOS prints the error message: 

%STRING TOO LONG 

You must then reissue the Find command with fewer characters in 
the string. 

If you specify more than six strings in the extended format of 
the Find command, SOS prints the error message: 

%T00 MANY STRINGS 

and the Find command is canceled. You must reissue the Find 
command with six strings or less. 
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If you issue a Find command with the /C128 option set using 
incorrect, special-matching characters from those described in 
the Substitute command, SOS will print the error message: 

%SEARCH STRING TOO COMPLEX 



Examples 



You search the text below using the Find command to locate the 
word FIND and alter it to FINDS. 

*pioo:200 GnD 

00.100 THE F COMMAND FIND THE FIRST OCCURRENCE 
00200 OF CHARACTERS LOCATED WITHIN RANGE OF LINES. 



*FF I ND*1 00 » A GiD 

001.00 THE F COMMAND FINDS THE FIRST OCCURRENCE 

t "t 

* 

You search in lines 100 through 200 for two text strings that 
exactly match your typed input, and open the Alter mode to alter 
each string so that it is correct. 

* F C C I..I R R E N C E QfD 
W 1 TH I N* 1 00 : 200 y A r E C^^TT) 
t 



00.100 THE F COMMAND FINDS THE FIRST OCCURRENCE OF A STRING 

t f 

W I OF A STRING QsDCItD 
00200 OF CHARACTERS LOCATED WITHIN A RANGE OF LINES. 

t t 

7 C SP ) I A C KSC ) ( KtT ) 

*pioo:200 QiD 

00100 THE F COMMAND FINDS THE FIRST OCCURRENCE OF A STRING 
00200 OF CHARACTERS LOCATED WITHIN A RANGE OF LINES. 
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5.12 60 - G COMMAND 
Function 



The Go command permits you to end an SOS session, save your file, 
and perform your last COMPILE, LOAD, EXECUTE, or DEBUG command. 
You may also execute other TOPS-10 programs, compilers, and 
utilities with the Go command by setting the /RUN option before 
issuing the Go command. 

Format 

*Gm: filespec GID 

Options 

m is a modifier that can be either fi, D, Q, S, or a 

combination of B and S. 

B suppresses creation of a backup file with the 
extension Qxt; also suppresses the creation of a 
backup file with the extension Zxt if the /OLD 
option is set. 

D deletes both the original file (input to SOS) and 
your edited file (output from SOS) . 

Q quits so that all changes to the original file 
from the time of the last backup to the present 
are lost. 

S unsequences (that is strips line numbers from) the 
output file. 

tfilespec is the file specification of " the output 
(destination) file. This file specification can 
consist of the following: 

dev:f ilnam.ext [p,pn,sfdl, . . . ] <nnn> 

This argument is optional; if it is omitted, the 
current file is used. (Refer to Chapter 2, Giving 
Commands, for a complete description of these file 
specifications.) 

Hints 

To save the file without line numbers, do one of the following: 

1. Place the /UNSEQUENCE option in your SWITCH.INI file. When 
you do, the option automatically applies to every file you 
create or edit with SOS. 
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2. Include the /UNSEQUENCE option in your SOS command: 

.SOS/UNSEQUENCE filespec C^iD 

3. Set the /UNSEQUENCE option before you give the Go command. 

4. Give the GS command. 

You may include the /RUN option in your SWITCH.INI file to 
indicate the name of the program to which your file will "go" 
after giving the Go command. You can use the command 
/RUN:dev: filespec or the option /RUN: filespec. If you do not 
specify the device (dev) , the SOS default SYS: is used. 



Restrictions 



If the file you indicate is the current file being edited, SOS 
replies with the message: 

*G:TEST.ALGC2lD 

OUTPUT FILE EXISTS - DELETE? (Y OR N) : 

To confirm that you intend to write over this file, you must 
reply with either a Y (for Yes) or a N (for No) . You do not need 
to press RETURN. SOS responds with ES of YES or of NO. If 
your reply is N, SOS asks for a new name of the file: 

FILE: 

and you supply a new file specification. SOS will then save the 
contents of the current file in the file you specify. 

In some conditions, the Qxt backup file may become 
write-protected. SOS will create or write over the backup file 
and, in addition, print the message: 

%BACKUP FILE PROTECTED - IGNORED 

If the file is protected and you cannot overwrite it, SOS prints: 

?FILE WRITE PROTECTED. TRY ANOTHER NAME 
FILE: 

after which you should specify a new file specification. 

If you type an illegal file specification, SOS prints: 

% ILLEGAL COMMAND 
* 

If you give the Go command without setting the /RUN option or you 
have not previously given an EXECUTE, COMPILE, LOAD, or DEBUG 
command at TOPS-10 command level for your file, the system 
returns the TOPS-10 error message: 

7CMLNPC NO PREVIOUS COMMAND 
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Examples 

The following two examples show two basic methods used with the 
Go command. 

1. You compile a FORTRAN program source file at TOPS-10 command 
level, but find errors in the source code. You the edit the file 
using the Substitute command and issue the Go command with no 
arguments, SOS defaults to the last COMPILE command. 

♦ COMPILE NUMBER ♦ FGFs* GlD 
FORTRAN: NUMBER 

00080 TIPE lOAfXfY 

TPTNNRC line: 00080 STATEMENT NOT RECOGNIZED 

TFTNFTL MAIN, 1 FATAL ERRORS AND NO WARNINGS 

»SOS NUMBER » FOR C^TT) 
edit: NUMBER ♦FOR 
*STIPE*TYPE*"^;* C^TTj 
ft" 

( ISC ) CHI) 

00060 103 FORMAT <' YOU TYPED THE NUMBER 'yf) 
00080 TYPE lOAfXfY 

*G ( f~KH ) 

LDSKC:NUMBER,F0RI-27»^)1073J 

FORTRAN: NUMBER 
MAIN, 
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2. You perforin the same edit on the source program file and then set 
the /RUN option specifying the system program that will process 
your file when you give the Go command. You give a Go command 
(GBS:NUM.FOR) that suppresses the creation of a backup file, 
removes the line numbers, and specifies a new file specification 
for your source program code. 

♦ SOS NUMBER ♦F"ORGhD 

edit: number* for 
*s fife* type*" : * ced 

t t 

CUD c ESC ) 

00060 103 FORMAT <' YOU TYPED THE NUMBER 'rF) 
00080 TYPE 104rXfY 

*/RUN : SYS : FORTRA CED 
»cGBS:NUM> FOR r^jT) 

i:dskc:num.for:i 
fortran j num 

MAIN* 

link: loading 
clnkxct num execution] 
please type a number* 

45 ( Hfct ) 

YOU TYPED THE NUMBER 45*0000000 
TWICE 45*0000000 IS 90*0000000 

END OF EXECUTION 

CPU time: 0*12 ELAPSED TIME? 4.00 

EXIT 
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5.13 HELP - H COMMAND 

Function 

The Help command prints on your terminal a summary of all SOS 
commands, options, and additional information about SOS. 

Format 
*H 

Restrictions 

If your system does not have a HELP file for SOS, SOS prints the 
following error message: 

%I'M SORRY I CAN'T HELP YOU 
Example 

#H GED 

Summary of SOS commands X'v'21<134) + l-APR-78 LCG/SDG 

A Alter r.<ran<3e>3 

riC<ch> Change n characters 

-nil Delete neMt/previous characters 

E Finish with no printing 
nI<teKt>$ Insert with temporary increment n 

J Break line and stick rest at front of next 

-nK<ch> Delete to n occurrences of <ch> 

L Print line and recycle 

P Print line and recycle to current position 

Q Quit ALTER (restore ori^Jinal line) 
-nR<teMt>$ Delete n char* then Insert text 

-nS<ch> Search forward/backward for n occurrence of <ch> 

nV (Optional) insert case for n char's or to end of word 

nW Skip forward n words 

X<text>$ Delete word then Insert text 

n<SP> Space fov{>4Brd n characters 

<RET> Finish and print rest of line 

n<DEL> Backspace n characters 

n<BS> Backspace n characters 

-<TAB> Skip to end/start of line 

'"U Quit and restart ALTER 
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G 

H 
I 
J 
Jc 



NA 



T 



X 

* 

/ 

<LF> 

<e:sc> 

<DEL> 

<CTRL/C 

<CTFi;L/G 

<CTRL/R 

<CTRL/U 



Copy C<destin3tion>j'<r3nde>II 

or C <desi i nati on>~<f i 1 nsm ♦ ext> r <ran^e>l 
or [;<destiri3tion>-<f ilri3m»eMt>/S3 
Delete L<r3ri£je> » Y3 (jY for msssive deletions) 
End C. ■:; m > t < f i 1 n 3 m ♦ e x t > 3 
B Suppress ♦Qxt/*Zxt file crest ion 
D Delete both input/output to SOS 
Q Quit (restore to ori^insl file) 
S Unse«uence output file 

Find C:<st rin£{>$ <r3n^e> r <options>II or 

C <st r i nd 1 > thru <st r i nd6>*< r3nse> f <opt i ons> 1 

G c) t ■••:,■ m > * < f i 1 n 3 01 ♦ e ;•( t > 3 

(End and do l3st Lo3d-cl3SS comiTisnd) 
Help (twpes this text) 
I nse vt Z <pos i t i on> r < i nc rement> 3 
Join C:<Position>3 

■■'.ran^e>l 





Justify (Option3l) C< 


c 


Justify center 


L.. 


Justify ~ flush left 


R 


Justify - flush ri:^ht 


U 


Justify and fill 


tJ 


Justify word 




Kill C/<P3Se-number>3 



List (on LPT) L<r3n^e>i'S3 (rS for no line no's) 

hark C<Position>3 

Numbe r [] < i nc renient> r <ran^e> ? <st 3 r t> 3 

Add <increrTient> to <ran^e> 

Preserve line numbers over psde msrks 

Print C<r3n£ie>r S3 (»S for no line no's) 

Rsrii^e r.<ran*:ie>y <increiTierit>3 

Substitute C<strin£j>$<new--strin^>*<r3nde>»<options>3 

or 
C<strindl> thru <strinia6>* 

<new-strin£fl> thru <new~strin^6>* 

<r3n<3e> y <options>3 
T r ansf e r L <des t i nst i on> r < r 3nde> 3 
in'^ert (Optional) C<c><r3n£fe>3 
L Invert upperc3se to lowercsse 
U Invert lowerc3se to uppercase 
V Invert upper to lower/lower to upper 
World (S3ve-the-"World)' 

S3irie 3s Ey hut doesn't end SOS) 
extend C<r3n^e>»S3 (rS suppresses typeout) 
Move pointer [;<position>3 
I nd i rect L < ♦ f i 1 nam ♦ ex t> 3 
G i V €^ C < o p t i o ri .:=• 3 
Set r <op t i on> t < V3 1 ue> 3 
P*fl (Print next line) 
Pt~l (Print previous line) 

(Delete one character) 

(Stop SOS) (Yes? Type H for Help) 

(Cancel SOS command) 

(Print line without line number) 

(Erase and retype current line) 



***)K OptionBl commands must be assembled for your SOS **** 
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SOS Options { 



<Y for Yes» N for No) 



name 



set</) pririt( = ) default 



irieariind 



BAK 

BASIC 

BIG 

C64 

C128 

CASE 

DECIDE 

DELETE 

DISK 

DPY 

ERROR 

EXPERT 

INCREMENT 

ISAVE 

LENGTH 

LMAR 

LOCATION 

LOWER 

M33 

M37 

MAXLN 

NAME 

NOBAK 

NODECIDE 

NODELETE 



NONSEPARATORS 



NONUMBER 

NOVICE 

NUMBER 

OLD 

OPTION 

* (Period) 

PLINES 

PMAR 

READONLY 

RMAR 

RUN 

SAVE 

SEPARATORS 

SEQUENCE 

START 

STEP 

STRING 

UNSEQUENCE 

UPPER 



Y 

N 

Y 

CASE 

CASE 

Y 

Y 

Y 

Y 

CASE 

Y 

N 

Y 

Y 

Y 

Y 

Y 

CASE 

CASE 

Y 

Y 

BAK 

DECIDE 

DELETE 

Y 

N 

N 

N 

N 

N 

Y 

Y 

Y 

N 

Y 

Y 

Y 

Y 

Y 

Y 

Y 

SEO 

CASE 



On 
Off 

On 
Off 

Off 
Off 

Off 

Off 

100 



55 

1 

Off 

On 

Off 

99999 

input 

Off 

On 

On 

CASE 

Off 

On 

Ori 

Off 



16 

1 

Off 

69 

SYS:COMPIL 



Off 

On 

100 

100 

Off 
On 



Create backup file <»Q>ct> 
Edit BASIC program 
Print larslest PB^e no* 
64 character set 
128 character set 
Give case information 
Auto rD for S conimand 
Delete input/outPut file 
Disk auota information 
VT05 terminal type 
Print last error messaiSe 
Expert assumption 
Default line increment 
Auto-Save for insertion 
Printed lines/pade 
Left mar^ain 

First line in SOS buffer 
Input lowercase chrs 
Terminal characteristics 
Terminal characteristics 
Maximum line numbers 
Output file specification 
No backup file creation 
No auto I'D for S cmd» 
No delete of I/O files 
On %»*!»♦ not punctuation 
No line no» printing 
Normal mode assumption 
Print line numbers 
Create <»Zxt> backup file 
Set options in SWITCH* INI 
Print current -.'positions- 
Number lines by P<RET> 
Paragraph margin 
Read file onlyr no edits 
Ri^ht margin 
Set run specifications 
Auto-Save for editinst 
%»$!»» are punctuation 
Seouence output file 
First line number seauence 
Sequence % increment lines 
Current F & S strings 
Unseouence output file 
Input uppercase chrs* 



DECIDE Mode (fD option of S command) Commands* 



<SP> 
<DEL 

A 

E 

G 

Q 



To accept this substitution* 

To reject this substitution* 

To do this substitution!' then enter Alter mode* 

To reject substitution and return to Edit mode* 

To accept this substitution and all others* 

To «uit substitutions and Decide NOW* 
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SOS <optioris> of the Find and Substitute Comiridnds* 

<option> Hesninsl* 

>A Enter Alter mode (F command onlw) 
yD Give Decide mode commands (S command onl«^) 
fN Sujs-press typeout of line (F and S command) 
fE Exact match of upper/lower case <F and S command) 
^number Intesjer value for number of lines <F and S command) 



SOS Special Characters (for Find & Substitute commands)} 



Replacement* 



Match: 



"B 


/ ■ 


'"0 


'* 


*^ f*% 


/7 


"E 


'% 


'^N 


') 


"T 


'/ 


«« 


'7 



next match strinsj 

'*<number>'* is n'th match strinsi 

Quote next character 

not 

arbitrary number of 

any character 

ouote next character 

separator 



SOS Position Symbols* 



present line or fa^e 
first line or Fa^e 
last line or fa^e 



SOS Definitions and Meanings* 



-■sransle> 

<position> 

<line> 

••■•".pa £{©.'•■■ 
<content> 
<des tins t ion. > 
<numbe?r> 
<strin£{> 



- <Position>C ! <number> or J<Position>3 

= C<1 ine~number>3C/<pa£{e--number>3 

~ n<number> or <content> or 

. or * or "3C <+-)<number>3 

- ir<number> or ♦ or * or "^C <+-)<number>3 

- *<strin!3>*<r3nsie>»<options> 
~ <POsitiori> 

= (any positive intesier .LE* 2'"35-l ) 

"■ (any string of characters) 

(200 maximum with F S S commands) 
(497 maximum per line contents) 
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SOS Monitor Command Format* 

♦ SOS /options filn3m»e){t or 

♦SOS f ilnam^ext/options or 

♦R SOS-/oFtions filnam^ext or 
♦R SOS-f ilnam^ext/options 

<f ilnam^ex't.:- ♦♦= (filename and file extension) or 

<f i 1 n82 ♦ e>ct>=<f i 1 naS ♦ ext> 

whereJ <filnam*eKt> = file to create/edit 
<f iln32»ext:> = output file 
<filna3»ext> = input file 

<f iln3m♦ext> 
<filn32♦eMt> : I- CdevnCf iln3m3C*ext3C<P3th>3C<prot>3L<key>3 
<f ilnaS^ext-'-'- 
Oathx- ♦ ♦=•• C-3 default path 

Cpriipa] ppn only 

Cprrpi3fsfd3 full path specification 

C»rsfd3 use own ppn 

<prot> *t~ <nnn> octal protection code 

<key> ♦♦- <<up to 20 characters^) encryption key 



SOS J Insufficient Disk Space - WELL? 

Commandst <No Guarantees!) 

G •" do the output (now and forever)* 
T ~ test disk space and do output 

if space available* 
R ~ £{ive resources and do output 

if space available* 
W - wait until either space appears or you type 

a different response* 

CEnd of S0S*HLP3 
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5.14 INSERT - I COMMAND 

Function 

The Insert command starts Input mode for one or more lines. If 
you insert more than one line, you must press ESCape to leave 
Input mode. 



Format 



*Iposition, increment QtE) 

or 
*Iposition; incrementQm 

or 
*Iposition; 1 number C^tT) 



Argument 



position is the position of the line you want to insert. 
If the line already exists, SOS selects a line by 
adding the current value of the INCREMENT option 
to the indicated line number. If the resulting 
line also exists, then SOS chooses a line halfway 
between the indicated line and the next line in 
the file. 

To insert a line at the very top of a page, use 
the up-arr:ow (") ; e.g. l". SOS chooses a line 
halfway between line and the first line in the 
page. 

To insert a new page mark, use a 
position/page-number format, where page-number is 
the current page. SOS starts inserting a new page 
immediately after the indicated page. SOS 
automatically increments subsequent page marks by 
one. 



Option 



, increment is the numeric increment SOS uses for creating new 
lines during execution of the current and further 
Insert commands. The , (comma) increment changes 
the value of the INCREMENT option. Further Insert 
commands will use this increment by default for as 
long as lines can be inserted on that page. You 
may choose to stop inserting lines by pressing 
ESCape. 
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; increment is the numeric increment SOS uses for cr%ating new 
lines during execution of the current Insert 
command. The ; (semicolon) increment does not 
change the value of the INCREMENT option beyond 
the command itself. Further Insert commands will 
use the value of the INCREMENT option (default is 
100) if an increment is not specified in the 
command . 



; 1 number 



specifies the number of 1 
the position. SOS inc 
table of increment values 
source-program. The tabl 
20, and 100. SOS determi 
to use by examining the 
position and the numbe 
numbers are inserted 
exhausted, until the incr 
until you press ESCape to 



ines to insert following 
rements the lines using a 

that are within the SOS 
e values are 1, 2, 5, 10, 
nes which increment value 
line number following the 
r you specified. Line 
until the number is 
ement is exhausted, or 

end the insertion. 



Hints 



To start inserting on a new page, give the Insert command with a 
page number position, not a line number position, SOS will 
increment each new line with the INCREMENT option value. 



Restrictions 



If you indicate a nonexistent page number, 
command and prints the following message: 



SOS cancels the 



%N0 SUCH PAGE 

If you try to insert an existing line when SOS cannot fit a line 
between the existing line and the next line in the file, SOS 
cancels the command and prints the message: 

% ILLEGAL REPLACEMENT ON INSERT 
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Examples 
1. 



You insert three lines and then stop Input mode by 
Escape. The default increment of 100 is assumed. 

*I500 GiD 

00500 THIS TEXT IS ON LINE SOO GiD 
00600 THIS TEXT IS ON LINE 600(J}Z) 
00700 THIS TEXT IS ON LINE yOOQtT) 
00800 $ 
t 



pressing 



You insert six lines immediately iafter the existing line 300 on 
page 3. By specifying an increment of , (comma) 10, you have 
changed the value of the INCREMENT option. 

*-=INCQ^ 
00100 

*I300/3»10Qtr) 
00310 BOSWORTH QiD 
REDCORTQrr) 

MULLEN GID 
FOXHILLO^TP) 



00320 
00330 
00340 
00350 
00360 
00370 



BELKNAPCTTT) 

MILLWOOD GID 
* 

t 



*==INCGID 

00010 

* 

3. You insert a line at the top of page 4. 

*i'V4 GE) , , 

00050 ; THIS PROGRAM CONVERTS FROM POUNDS TO KILOGRAMS . C«iD 

4. You start a new page after the existing page 2, the current page 

*P*/2 O^ 

00900 THIS IS THE LAST LINE ON PAGE 2» 
*!/» QeT) 

00100 THIS LINE IS THE FIRST LINE ON THE THIRD PAGEGlD 
00200 OF THE FILE, QiD 
00300 * 
t 
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5.15 JOIN - J COMMAND 

Function 

The Join command joins two consecutive lines together by 

appending the contents of the second line onto the end of the 

first. After appending the second line, SOS deletes it from the 
file. 

Format 

*Jposition ( KtT ) 

Argument 

position is the first line to which the next consecutive 
line will be appended. For example, the command 
*J200 will join line number 300 to 200 and delete 
300 from the file (assuming the SOS increment 
default of 100) . 

Restrictions 

If joining the two lines creates a line containing more than 497 
characters, SOS prints: 

%LINE TOO LONG 

and does not join the lines. 

If the line is the last line on the page or the last line in the 
file, SOS prints: 

%N0 NEXT LINE 

and cancels the command. 

Example 

1. You print lines 100 and 200 and then join the line contents of 
line number 200 to the end of line number 100. 



»P10Q:200(. ku 

00100 THIS IS THE FIRST LINE 

00200 ~ THIS IS THE SECOND* 

*piooj20oc«rr) 

00100 THIS IS THE FIRST LINE - THIS IS THE SECOND* 
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5.16 JUSTIFICATION - JC, JL, JR, JU, JW COMMANDS 

Function 

The Justification commands are optional SOS commands and must be 
assembled for your installation of SOS. 

The Justification commands allow you to perform text 
justification (text arrangement) when you are editing a text 
file. A text file contains information such as the contents of a 
book. 

When this command is in effect, the LENGTH, LMAR, PMAR, and RMAR 
options can be changed in value and will have an effect during an 
SOS session. The MAXLN option may also have some effect, if the 
text file exceeds its option value (99999 by default) . 

Format 

*Jcrange QED 

Argument 

c must be a C, L, R, U, or w, and must accompany the 

J command. If they are not used, the 
Justification command becomes a Join command. 

C centers the text lines specified by the range 
between the LMAR value and the RMAR value. Spaces 
are padded from the left margin to center the 
lines. 

L justifies the text lines specified by the range so 
that each line starts at the left margin. 

R justifies the text lines specified by the range so 
that each line ends at the right margin. 

U justifies and fills the text lines specified by 
the range so that each line will fill the number 
of positions in the line. The number of positions 
is determined by RMAR-LMAR+1 = line length. When 
the JU command is executing, the line numbers, 
carriage returns, and linefeeds in the range are 
ignored. 

W justifies by word, but does not fill with spaces, 
the text lines specified by the range so that each 
line will be justified to the value of the LMAR 
option. If the next word cannot fit on the line, 
the word becomes the first word on the next line 
in the range. There is no justified right margin. 
When the JW command is executing, the line 
numbers, carriage returns, and linefeeds in the 
range are ignored. 
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range specifies the range of text lines you want to 

justify. If the range specified is the argument 
of the JU or JW command, only the specified lines 
are justified up to the first line that exceeds 
the MAXLN value. These two commands will insert 
line numbers and/or renumber the file. 

(Refer to the examples for a better understanding 
of how these commands work.) 



Restrictions 



If a text line exceeds the right margin (RMAR) value during 
execution of the JC, JL, or JR commands, SOS prints the following 
error message for each text line in the range: 

%LINE TOO LONG 

If for some reason the right margin (RMAR) value becomes less 
than the left margin (LMAR) value, SOS will print the error 
message: 

% MARGIN ERROR 

and justification will not take place. 

Examples 

The following examples illustrate the Justification commands 
using the text taken from the first two paragraphs of this 
section of Chapter 5. The first two lines illustrate the 
positions of the text characters with various values of the LMAR, 
PMAR, and RMAR options. 

1. The following example shows the file as it was created. 

♦SOS JUSTtMEM QiD 
Edit: JUSTtMEM 
*P/1 CUD 

Pas^e 1 

00010 11111111112222222222333:533333344444444445 

00020 12345678901234567890123456789012345678901234567890 

00030 

00040 The Jusii first ion corrimands 

00050 are optional SOS comnonds 

00060 <3nd must be assembled for 

00070 your installation of SOS» 

00080 

00090 Th»e Justification commands 

00100 allow you to perform text 

00110 Justification <text 

00120 arran'^ement ) when you are 

00130 editin«3 a text file* 

00140 A text file 

00150 contains information 

00160 such as the? contents of a 

00170 book. 

* /RMAR I 50 Oni) 

* 
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Line 00030 contains all spaces and a carriage return. Line 00080 
contains a TAB and a carriage return. For demonstration 
purposes, the RMAR value has been set to 50. LMAR and PMAR have 
their default value of 1. MAXLN will remain at its default value 
of 99999, and the LENGTH option will remain at 55. 

The following example illustrates the JC command for the range of 
lines 30 through 170: 

*jc3o:i70 CIE) 
*p/i rTTD 



Pane 1 

00010 

00020 

00030 

00040 

00050 

00060 

00070 

00080 

00090 

00100 

00110 

00120 

00130 

00140 

00150 

OOIAO 

00170 



11111111112222222222333333333344444444445 
12345678901234567890123456789012345678901234567890 

The Justification commands 
are optional SOS commands 
and must he assemhled for 
^^our installation of SOS* 

The Justification commands 
allow \Jou to perform text 

Justification (text 

arranj^ement ) when you are 

editinis a text file* 

A text file 
contains information 
such as the contents of a 
hook f 



In the above example, each line is centered in the file, 
are added to the left margin for center justification. 



Spaces 



In this example, the JL command justifies this text file to the 
left margin as it was in- the first example. The only difference 
will be LMAR with a value of 5. 



*/LMAR:5(. hh 
» JL30:i70O^rP) 
*P/1 (JeT) 



Fade 1 

00010 

00020 

00030 

00040 

00050 

00060 

00070 

00080 

00090 

00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 

* 



11111111112222222222333333333344444444445 
12345678901234567890123456789012345678901234567890 

The Justification commands 
are optional SOS commands 
and must be assembled for 
your installation of SOS* 

The Justification commands 
allow you to perform text 
Justification <text 
arrani^ement ) when you are 
editinsi a text file* 
A text file 
contains information 
such as the contents of a 
book * 
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With the LMAR option set to 5, each line will start at that 
position. Each line ends with a carriage return after the last 
word. 



In this example, the JR command is used with the RMAR option 
to 50. 

*/rmar:50C1ID 

*JR30:i70 
*P/1 QfjJ 



set 



p3£ie 1 

00010 

00020 

00030 

00040 

00050 

00060 

00070 

00080 

00090 

00100 

00110 

00120 

00130 

00140 

00150 

00160 

00170 



11111111 1 12222222222333333333344444444445 
12345678901234567890123456789012345678901234567890 

The Justification coitimands 
are optional SOS commands 
and must be assembled for 
your installation of SOS* 

The Justification commands 

allow you to perform text 

Justification (text 

arransJement ) when you are 

editing a text file* 

A text file 

contains information 

such as the contents of a 

book ♦ 



In the example above, each line ends at the RMAR option value of 
50, and spaces are padded to the left of each line. 

In this example of the JU command, the PMAR option is set to 10, 
RMAR is set to 50, and LMAR is set to 5. 

*/PMARJ10QtD 
*/RhAR:50C"^I7^ 
*/lmar:5 QT?) 

*JU30:i70 ClIT) 
*P/1 O^TT) 



Pa^e 1 

00010 

00020 

00030 

00040 

00055 

00067 

00083 

00101 

00120 

00140 



11111111 1 12222222222333333333344444444445 
12345678901234567890123456789012345678901234567890 

The Justification commands are optional 
SOS commands and must be assembled for your 
installation of SOS* 

The Justification commands allow you to 
perform text Justification (text arranisement ) 
when you are editinsJ a text file* A text file 
contains information such as the contents of a 
book ♦ 



In the example above, the JU command justified the text file and 
added spaces between words to fill the entire length of the line 
(RMAR-LMAR+l=line length). Any word that ends with period (.), 
question-mark (?) , or exclamation (!) may have additional spaces 
padded to it to fill out the line. 
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The JU command deletes line numbers and creates new line numbers 
when the contents of the line, can be appended to the line 
preceding it. For example, the first line (00030) was expanded 
to include the contents of lines 00040, line 00040 became the 
contents of lines 00050 and 00060. The remainder of line 70 
became line 00055, etc. 

The indentation of the first line of a paragraph is determined by 
the following conditions: 

1. a TAB as the first character of a line, or 

2. a line filled with spaces, or 

3. a page mark, or 

4. the beginning or ending of the specified range. 

Line 00030 in example 3 contained a carriage return and also was 
the beginning of the range. Line 00080 contained a TAB and a 
carriage return indicating a new paragraph. Therefore, a new 
paragraph was created when the JU command used the contents of 
lines 00090 through 00170. 

If the specified range had exceeded the value of the MAXLN 
option, the JU command would have stopped at the point before the 
first line that exceeded the value. Any remaining lines would 
remain in their original context and format. 

If a TAB is encountered as the first character of a paragraph, 
the TAB will become the first character of the paragraph and the 
PMAR option value is ignored. In the example above, the first 
character in the second paragraph started in position 9, since a 
TAB preceded it. 

6. In this example, the JW command is used on the text file as it 
appears in the first example of this section. The JW command 
will fill the contents with blanks (or spaces) when the next word 
it encounters cannot fit into the line being created. 

*/LMAR{5 C^FT) 
#/RMAR:50QFr) 

*jw3o:i7oc^ 
*Fvi GID 

pBvie 1 

00010 11111111 1 12222222222333333333344444444445 

00020 1234^)678901 234567890123456789012345678901 234S67890 

00030 The Justification commands arts optional 

00040 SOS commands anti must be assembled for your 

00055 installation of SOS* 

00067 The Justification commands allow you to 

00083 perform text Justification (text arrangement) 

00101 when you are editin*^ a text file* A text file 

00120 contains information such as the contents of a 

00140 book* 

* 
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In the example above, the JW command justifies each line to the 
value of the LMAR and PMAR options; and does not fill each line 
with blanks as the JU command does. The exception is that the JW 
command treats words ending with a period (.), question- mark 
(?) , or exclamation (!) the same as the JU command. Additional 
words from each preceding line are added to the previous line to 
justify that line. If the word is too long to fit, it becomes 
the beginning word of the next line. Since line numbers are 
ignored, line number insertion is done at random increments. 



CAUTION 

If you assemble your installation of SOS 
so that this command is operational, it 
is recommended that you practice using 
the Justification commands since they 
may produce some unpredicitable results 
when the LMAR, PMAR, and RMAR options 
have been reset from their default 
values. 
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K 



5.17 KILL - K COMMAND 

Function 

The Kill command deletes the indicated page mark and appends the 
page contents onto the previous page; that is, the Kill command 
deletes only the page mark, not the contents of the page. 

Format 

*K/page-number QeT) 
Argument 

page-number is the number of the page mark you want deleted. 



Hint 



The Kill command is the only command that deletes just a page 
mark. The D command is capable of deleting both page marks and 
text. 



Restrictions 

If any of the line numbers following the page mark match or are 
smaller than the line numbers on the page to which they are 
appended, SOS prints the message: 

%OUT OF ORDER 

To renumber the lines, give the Number command. 

If you specify a page number that does not exist, SOS prints the 
message: 

%N0 SUCH PAGE 

and returns you to SOS command level. 

Examples 

1. The following text file will be used to illustrate the Kill 
command: 

00100 THIS IS PAGE ONE FOR THE K COMMAND 

PAGE 2 

00100 THIS IS PAGE TWO FOR THE K COMMAND 

PAGE 3 

00100 THIS IS PAGE THREE FOR THE K COMMAND 

PAGE 4 

00100 THIS IS PAGE FOUR FOR THE K COMMAND 

* 
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2. You kill the page mark for PAGE 4 and then renumber the file. 

%OUT OF ORDER 

* 

3. You attempt to kill the same page mark again and get the error 
message: %N0 SUCH PAGE. 

*K/4 CEnD 

'/.NO SUCH PAGE 
* 

4. You set the SOS session to EXPERT mode and continue to kill all 
additional page marks. Note that page mark 2 is the first page 
mark in the file, thus the command K/1 is illegal. 

*/EXF-ERT CETT) 
*KV3 QED 

%ORDER 
*K/2 (JtT) 

%ORDER 

*K/1 QFT) 

%NSP 

*=ERROR (JjT) 
%N0 SUCH PAGE 
*P/1 (JtT) 

PAGE 1 

00100 THIS IS PAGE ONE FOR THE K COMMAND 

00200 THIS IS PAGE TWO FOR THE K COMMAND 

00300 THIS IS PAGE THREE FOR THE K COMMAND 

00400 THIS IS PAGE FOUR FOR THE K COMMAND 

* 
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5.18 LIST - L COMMAND 

Function 

The List command prints on the line printer, without ending SOS, 
the range of lines specified in the command. After you give the 
List command, your current position is after the last line 
printed. 

Format 

*Lrange,S QID 

Argument 

range specifies which lines SOS prints. If omitted, SOS 

prints the entire file. 



Option 



,S stops SOS from printing line numbers, headings, 

and page numbers. 



Hints 



To make the line printer listing more readable, SOS gives each 
page a heading that includes the name of the file, the time and 
date of the printing, and a page number. Each SOS page starts a 
new line printer page. Page numbers have the form s-1; s is the 
SOS page number, 1 is the sub-page number of that SOS page. If 
it takes 4 line printer pages to print SOS page 4, the pages are 
numbered 4, 4-1, 4-2, and 4-3. 

Remember, to eliminate the headings, line numbers, and page 
numbers, use the ,S option of the List command. 



Restrictions 



When you give the List command, the system attempts to print the 
specified contents on any available printer. If no line printer 
is available at that time, the operator of the system must issue 
a command to continue the request for a line printer. 
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It is recommended, for best results, that you spool your output, 
to avoid any possible problems with the List command. 

( SP ^ ( SP ) 

i I , ^ 

♦ SET SPOOL LPTCED 
. S 5 !r> A M P I, E . T X J (JTD 
edit: sample ♦TXT 

*L y S CZlD 

* 

In this example, the List command will spool your output and it 
will print when a line printer becomes available. 



Examples 



*L100 QlD 
* 

When this List command is executed, the printed output on the 
line printer appears as follows. The headings give the file name 
(LIST. EXP) , the current date and time, and the page number. 

LIST. EXP 22-JUL-77 14:39:03 PAGE 1 

00100 THE L COMMAND LISTS A RANGE OF LINES 

When this List command is executed, the printed output on the 
line printer appears as follows: 

LIST, EXP 22-JUL-77 14:43:58 PAGE 1 

00100 THE L COMMAND LISTS A RANGE OF LINES 

00200 ON THE LINE PRINTER. 

00300 IF YOU DO NOT SPECIFY A RANGE, 

00400 T^E SYSTEM LISTS THE ENTIRE FILE. 

JtLrSdlD 

when this List command is executed, the printed output on the 
line printer appears as follows: 

THE L COMMAND LISTS A RANGE OF LINES 

ON THE LINE PRINTER. 

IF YOU DO NOT SPECIFY A RANGE, 

THE SYSTEM LISTS THE ENTIRE FILE. 
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M 



5.19 MARK - M COMMAND 

Function 

The Mark command inserts a new page mark immediately before the 
specified line. Your position is now the first line of a new 
page. (Refer to Chapter 3 for a description of the page mark 
format. ) 

After inserting the page mark, SOS renumbers the subsequent 
pages; lines retain their numbers, but each page number 
increases by 1. For example, if your file has 5 pages and you 
insert a new page mark in the middle of page 3, the new page mark 
is page 4, the old page 4 is now page 5, and the old page 5 is 
now page 6. Pages 1 and 2 remain the same. 

Format 

*Mline-number/page-number ( ret ) 

Argument 

line-number is the line number before which SOS inserts the 
page mark. If omitted, SOS uses the first line on 
the page. 



Option 



/page-number is the number of the page where the line is 
located. If omitted, SOS uses the current page. 



Special Cases 



If the line does not exist, SOS inserts the page mark on the 
indicated page just before the line with the next lower number. 

If the line is the first on the page, SOS inserts the new page 
mark after the existing page mark. Thus, the lines on the 
existing page now have their page number increased by 1. 

Hints 

The I/page-number command inserts a page mark and then allows you 
to insert lines, whereas the Mark command only allows you to 
insert the page mark. 

To review how to delete a page mark, refer to the Kill command. 

Restrictions 

If the Mark command specifies a page-number that does not exist, 
SOS prints the message: 

%N0 SUCH PAGE 

and does not attempt to insert a page mark. 
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Examples 

1. The following text file is used to illustrate the Mark command 
(notice that, at present, it is a one-page file): 

♦ sos mark. txt (tft) 
edit: mark.txt^ 

♦ PQFT) 

00100 THIS IS LINE ONE» PAGE ONE FOR M COMMAND EXAMPLE* 

00200 THIS IS LINE ONEr PAGE TWO FOR M COMMAND EXAMPLE. 

00300 THIS IS LINE ONE» PAGE THREE FOR M COMMAND EXAMPLE. 

00400 THIS IS LINE ONE» PAGE FOUR FOR M COMMAND EXAMPLE. 
* 

2. You mark line number 200 on page 1 as the page mark for a new 
page, page 2, and then you print the contents of page 2. 

*M200/1 QiD 

♦ P/2QID 

PAGE 2 

00200 THIS IS LINE ONEr PAGE TWO FOR M COMMAND EXAMPLE. 

00300 THIS IS LINE ONEr PAGE THREE FOR M COMMAND EXAMPLE. 

00400 THIS IS LINE ONEr PAGE FOUR FOR M COMMAND EXAMPLE. 

* 

3. You mark line number 300 as the next page in your file. After 
marking the line, SOS is now at the beginning of page 3, You 
print the contents of page 3. 

*M300 r^TT) 
*:P/3 C^u~) 

PAGE 3 

00300 THIS IS LINE ONEr PAGE THREE FOR M COMMAND EXAMPLE. 

00400 THIS IS LINE ONEr PAGE FOUR FOR M COMMAND EXAMPLE. 

* 

4. You mark line number 400 as the next page in your file. Line 
number 400 is now the first line on page 4. 

* 

5. After renumbering your file, it appears as follows: 



*N 

*p/":/»r^7r) 

PAGE 1 

00100 THIS IS LINE ONEr PAGE ONE FOR M COMMAND EXAMPLE. 

PAOE 2 

00100 THIS IS LINE ONEr PAGE TWO FOR M COMMAND EXAMPLE. 

PAGE 3 

00100 THIS IS LINE ONEr PAGE THREE FOR M COMMAND EXAMPLE 

PAGE 4 

00100 THIS IS LINE ONEr PAGE FOUR FOR M COMMAND EXAMPLE. 

* 
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5.20 NUMBER - N COMMAND 

Function 

The Number command renumbers the line numbers within your file. 
If you issue a Number command without any of its options 
(described below) , SOS defaults to a starting line number of 100 
for each page in your file with increments of 100. 

Format 

*Nx increment , range, starting-number ( «" ) 

Options 

X can be A or P. (Refer to Extended 

Characteristics below for a description of 
either the A or P option.) 

increment is the number SOS adds to calculate each 

succeeding line number. This number will also 
be the first line number if the starting-number 
option is not used with this command. If you 
omi*t the increment number, it defaults to 100. 

, range is the range of lines you want SOS to renumber. 

The range may be from a few lines to multiple 
pages. If the range is omitted, SOS renumbers 
the entire file. 

, starting-number is the number SOS assigns to the first 

renumbered line. If it is omitted, SOS uses 
the increment number. 

Special Cases 

There are cases where line numbers can get out of sequential 
order. While renumbering your file, SOS never reorders the 
actual line contents of your file, just the line numbers. The 
paragraphs below describe the circumstances and remedies for 
out-of-order line numbers. 



Hints 



You will probably need to give the Number command after you 
delete a page mark. (Refer to the Restrictions of the Kill 
command . ) 
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Restrictions 

%OUT OF ORDER 

Whenever SOS prints the above error message, your file has at 
least one page (if not more) with line numbers that are not in an 
increasing order. You should use the Number command to eliminate 
the confusion. 

When you kill page marks in files that have many pages or are 
extremely large in content, the %OUT OF ORDER error message may 
appear again after you issue a Number command. You should 
continue to issue the Number command as many times as necessary 
until the %OUT OF ORDER message no longer appears. 

%WRAP AROUND 

If you increment a page or pages of your file with an increment 
that does not leave enough line numbers between and 99999 for 
the contents of that page, SOS nevertheless attempts to keep 
adding the increment to produce the next line number. But, if 
the resulting line number is greater the 99999, SOS subtracts 
100000 to yield the line number it uses. This action is referred 
to as WRAP AROUND. You can correct it by giving another Number 
command with a smaller increment. 

Extended Characteristics 

*NAincrement, range QtT) 

NA adds an increment to a given range of line numbers. This is 
useful when you want to shift a block of line numbers, but 
preserve the low-order digits. 

In this example, you print the contents of your file, then 
renumber the file as a block of line numbers, each beginning with 
10000 plus its original line number. 



*P/1 (rm ) 


F-'AGE 1 




00100 


ONE 


00200 


TWO 


00300 


THREE 


00400 


F-OUR 


OO'oOO 


FIVE 


00600 


SIX 



*NA10000 7/1 QED 
»F'/lO^O 

PAGE 1 

10100 ONE 

10200 TWO 

10300 THREE 

10400 FOUR 

10500 FIVE 

10600 SIX 
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*NP increment, range, star ting-number 



NP renumbers your file in one continuing sequence; that is, SOS 
does not reset the line number to the SOS default of 100 at the 
beginning of each page. 

In this example, you mark line 10400 (from the previous example) 
to begin page 2 and then you renumber the entire file. Printing 
the file shows two pages with duplicate line numbers. You 
renumber the lines of both pages so there are no duplicate line 
numbers. 



*M10400 


(-0 


* N ( RtT ) 




*P/1 J/2 


(«") 


PAGE 1 




00100 


ONE 


00200 


TWO 


00300 


THREE 


PAGE 2 




001.00 


F-OUR 


00200 


FI^E 


00300 


SIX 


*NP100y 


/:i:/2 ( 


*P/1 t/2 


(RtT) 


PAGE 1 




00100 


ONE 


00200 


TWO 


00300 


THREE 


PAGE 2 




00400 


FOUR 


OOSOO 


FIVE 


00600 


SIX 


* 





GE) 
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Examples 

1, You kill page mark 2 and receive the error message: %OUT OF 
ORDER. By typing the Number command with the SOS default of 100, 
you correct the situation. 

#P/1 J/2Q7D 



PAGE 1 




00100 


ONE 


00200 


TWO 


00300 


THREE 


PAGE 2 




00100 


FOUR 


00200 


FIVE 


00300 


SIX 


*K/2 ( KIT ) 


ZOUT OF 


ORDER 


*NC «iT ) 




*P/1 (km 


:) 


PAGE 1 




00100 


ONE 


00200 


TWO 


00300 


THREE 


00400 


FOUR 


00500 


FIVE 


00600 


SIX 


* 





You renumber the entire file with increments of 25, and 
starting line number of 75. 



*N25t/1 


r 75 Oil 


*P/1 ( KM ) 


PAGE 1 




00075 


ONE 


00100 


TWO 


00125 


THREE 


00150 


FOUR 


00175 


FIVE 


00200 


SIX 


* 
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5.21 PRINT - P COMMAND 

Function 

The Print command prints a line or range of lines within your 
file. If the range extends to a new page or pages, the 
page-mark (s) are also printed. 

Format 

*Prange,S CreT) 



Options 



range is the range of lines you want SOS to print on your 
terminal. The range may be a single line number, a 
period (.), a up-arrow (") , an asterisk (*) , or the 
range may extend from a beginning line number/page 
number through an ending line number/page number. 

,S specifies that you do not want the line numbers to 
print. When using this option, you must press RETURN 
once after the S and then press RETURN again after the 
lines have printed to get the SOS prompt character (*) 
to reappear on your terminal. 

Hints 

If you do not specify a range, SOS prints a group of lines as 
specified by the value of the PLINES option. The default for 
this option is 16. 

Pressing Linefeed (LF) prints the next line within your file. 

Pressing ESCape (ESC) prints the previous line within your file. 

Restrictions 

%N0 SUCH LINE(S) 

Whenever SOS prints the above error message on your terminal, you 
have specified a range of lines that does not exist within your 
file. This message will also appear if you press either LF or 
ESC when the pointer is at the end of your file or at the 
beginning, respectively. 

If you specify a range of lines that begins with a line number 
that does exist to a line number that does not exist, no error 
message will appear and only those lines that exist will print on 
your terminal. 
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Examples 

1. You print line number 100 and the following line. 

*P100!2GiD 

00100 THIS IS LINE ONE» PAGE ONE 

00200 THIS IS LINE TUOr PAGE ONE 

* 

2. You press <LF> and print the next line within your file. 
00300 THIS IS LINE THREE » PAGE ONE 

3. You press <ESC> and print the previous line within your file. 

^ CUED 

00200 THIS IS LINE TWO^ PAGE ONE 

4. You attempt to print line number 400, which does not exist. 

*P4oon^ 



%Na SUCH LINE(S) 

5. You print a range of line and page numbers. The page marks and 
contents of page 1 and page 2 print on your terminal. Page 3 
does not exist and there is no error message. 

*p/i:/3Gir) 

PAGE 1 

00100 THIS IS LINE ONE r PAGE ONE 

00200 THIS IS LINE TUG r PAGE ONE 

00300 THIS IS LINE THREE r PAGE ONE 

PAGE 2 

00100 THIS IS LINE ONE» PAGE TWO 

00200 THIS IS LINE TWO» PAGE TWO 

00300 THIS IS LINE THREE if PAGE TWO 

6. You print line 300, suppressing the printing of the line number. 
By pressing RETURN either twice in succession or once again after 
the lines have printed, you cause the SOS prompt character to 
reappear on your terminal. 

THIS IS LINE THREE » PAGE TWO 

■ RET ; 
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5.22 REPLACE - R COMMAND 

Function 

The Replace command replaces a line or range of lines with a 
completely new line or range of lines that you type into the 
file. 

Format 

*Rrange, increment ( ku ) 
or 

*Rrange; increment Qiil) 

or 
*Rrange; ! number QuQ 

Argument 

range is the set of specified lines you want to replace. 



Option 



, increment is the numeric increment SOS uses for creating new 
lines during execution of the current and further 
Replace commands. This , (comma) increment 
changes the value of the INCREMENT option. 
Further Replace commands will use this increment 
by default if the lines can be inserted. You must 
then press ESCape to stop inserting lines. 

; increment is the numeric increment SOS uses for creating new 
lines during execution of the current Replace 
command. This ; (semicolon) increment does not 
change the value of the INCREMENT option. Further 
Replace commands will use the value of the 
INCREMENT option if an increment is not specified 
in the command and if the lines can be inserted. 
You must press ESCape to stop inserting lines. 

;!number specifies the number of lines to insert following 
the position being replaced. SOS increments the 
lines using a table of increment values that are 
within the SOS source-program. The table values 
are 1, 2, 5, 10, 20, and 100. SOS determines 
which increment value to use by examining the line 
number following the position and the number you 
specified. Line numbers are inserted until the 
number is exhausted, until the increment is 
exhausted, or until you press ESCape to end the 
insertion. 
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Special Cases 



You can terminate the Replace command and return to SOS command 
level by pressing ESCape. 



Hints 



The Replace command functions as if you gj*ve a Delete command 
followed by an Insert command. 

If you replace lines at the end of your file, the Replace command 
converts internally to the Insert command and allows you to 
continue inserting lines. 



Restrictions 



When you replace an entire file or page within a file, the 
message: MASSIVE DELETE OK? (Y OR N) : appears on your 
terminal. You must reply with a Y for Yes or N for No. This 
message will not appear if you are using the EXPERT option. 

If you specify a line or range of lines that do not exist, SOS 
replies with: 

%N0 SUCH LINE(S) 

Check the line number (s) within your file and retype the Replace 
command . 



Examples 

1. You replace line numbers 100 through 300 of a file, 
* R100:300 dD 



00100 THIS IS LINE lOOQIT) 

00200 THIS IS LINE 200 QIT) 

00300 THIS IS LINE ZOO C^TT) 

3 LINES (00100/1 :00300) DELETED 
* 
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You use the Give command to find out the present value of the 
INCREMENT option, and then you replace line numbers 400 and 500 
resetting the increment value to 50. SOS inserts line numbers 
450 and 550. Line 550 is added to the end of your file. At this 
point you may continue to insert lines. To return to SOS command 
level, press ESCape. 

*==--INC CEE) 

00100 

»R400? 500 > 50 OTTT) 

00400 REPLACE LINE 400 G^D 

INSERT LINE 450 0^) 

REPLACE LINE 500 (TtT) 

CONTINUE INSERTING LINES UNTIL YOU PRESS ESC KEY 

% 



00450 
00500 
00550 
00600 



t 



2 LINES (00400/1 : 00500) DELETED 

00050 

»/INC ? 100 O^TT) 

* 

When you specify an increment of 50 and use a comma before the 
50, you change the INCREMENT option value. To reset the 
INCREMENT option value, use the / (Set) command or issue another 
Replace command with the desired increment value. If you do not 
want to change the INCREMENT option value with the Replace 
command, use a semicolon before the increment. 

You replace line number 200 and insert line 210 and 220 before 
line number 300 in your file. The ;10 does not change the value 
of the INCREMENT option. 



*=-INCCEiD 

00100 

*R200?10 C^T) 

00200 REPLACE LINE 200 OF THIS TEXT FILEQID 

00210 AND INSERT LINE 210 THROUGH QeT) 

00220 LINE 220 BEFORE LINE 300 OF THIS FILE»* 



1 LINES (00200/1) DELETED 

*-^-INC d^T) 

00100 
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5.23 SUBSTITUTE - S COMMAND 

Function 

The Substitute command finds an existing string of characters, 
substitutes a new string of characters for the existing string, 
and prints the resulting line. The Substitute command performs 
this function for every line in a range. Your position is 
immediately after the last successful substitution. 

Format 

*Sex is ting-string$new-string$range,D,N,E, number Cull) 
t t 

( ESC ) ( ESC ) 

Arguments 

ex i sting-string 

is the string of characters that currently exists 
in your file. Unless you include the ,E option, 
uppercase characters match lowercase characters 
and vice versa. You may also use any combination 
of the special matching characters described 
below. 

$ ends the existing-string. The existing-str ing 

cannot exceed 200 characters. 

new-string is the string of characters that SOS substitutes 
for the existing string of characters. Both 
uppercase and lowercase characters are substituted 
exactly as you type them; that is, if you type a 
lowercase character, SOS places a lowercase 
character in the line. You may also use any 
combination of the special matching characters 
described below. 

$ ends the new-string. The new-string cannot exceed 

200 characters. 

range is the range over which SOS performs the 

substitution. If it is omitted, SOS makes the 
substitution only on the first line that contains 
the character string to be substituted. If you 
issue another Substitute command in the *S 
shortcut format (shown below) , the substitutions 
will take place throughout the rest of the file. 
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Options 



,D lets you decide whether each substitution should 

be performed. (Refer to the paragraph below 
describing the D option.) 

,N causes SOS to suppress the printing of the 

substitution for each line that contains the 
existing-string. The only response you receive 
will be the SOS asterisk prompt character. 

,E requires an exact match for the existing-string. 

Uppercase characters match only uppercase 
characters and lowercase characters match only 
lowercase characters. Place the ,E option after 
the ,N and ,D options, or else, if neither is 
present, after the range. 

, number specifies the maximum number of lines on which SOS 
is to perform the substitution. 



D Option 



After specifying the ,D option, you are allowed to check each 
substitution before SOS places it in the file. SOS prints the 
modified line and leaves a blank line. Then you may type one of 
the following characters: 

CEI) confirms the substitution for that line only and 

permits SOS to display the next line in the range 
where the substitution is to take place. 

C^K) deletes the substitution and the line is retained 

in its previous form. SOS proceeds to the next 
line in the range that contains the 
existing-string and displays it on your terminal, 
continuing the Decide mode. 

A enters Alter mode with the substitutions made in 

the line. All Alter mode instructions are valid; 
the pointer is positioned at the first character 
in the line. 

E exits from the Decide mode and returns you to SOS 

command mode without making this or further 
substitutions. 

G confirms the current substitution and lets SOS 

make the rest of the substitutions without asking 
for confirmation, i.e., ending the Decide mode. 

Q quits Decide mode for the current Substitution 

command. You immediately return to SOS command 
level. The only substitutions made were those 
that were confirmed previously. 
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Special Cases 



*S ( «" ) performs the last Substitute command from the next 
line through the end of the file. If you have not 
already given a Substitute command, SOS prints the 
message: 

%N0 STRING GIVEN 



*S$range,D,N,E,numberCED 

G^ 

substitutes the same new-string for the same 
existing-string as you gave in the last Substitute 
command. If you have not already given a 
Substitute command, SOS prints the message shown 
under the *S special case. Notice that you may 
leave out both strings, but you must press ESCape 
once. 

Extended Characteristics 

*Sexisting-strin gl ( ku ) 
existing-string2 ( kh ) 
existing-stringS CEEl) 
existing-string4 ( ret ) 
existing-stringSQtT) 
existing-string6$new-stringl C ret ) 

t 

new-string2 ( "ti ) 
new-string3 ( ret ) 
new-string4 QiD 
new-str ingS QeT) 
new-str ing6$ range, D,N,E, number QtD 

The above Substitute command substitutes new-stringl for 
existing-str ingl , new-string2 for existing-str ing2 , and so forth. 

You may use up to six existing-str ings and six new-strings. 
However, you may not have more than 200 characters total in all 
the strings. If you exceed either of these limits SOS prints one 
of the following messages: 

%T00 MANY STRINGS 

%STRING TOO LONG 

To substitute the same new-string for more than one 
existing-string, specify more existing-strings than new-strings. 
SOS substitutes the last new-string for the extra 
existing-strings. 
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Special Matching Characters 

The following characters perforin special matching. They 
represent a very powerful, yet sometimes complicated, way of 
using the Substitute command. For a complete description of the 
techniques used with these characters, refer to Chapter 7. You 
must set the /C128 option before specifying any of the special 
characters described below. 

The following two characters can represent a variety of 
characters: 



Character 


Can match: 


V 
1 . 


any single character 

any separator, that is, any character other than 
a letter, number, period (.), percent (%) , or 
Escape ($) 



The next three characters modify the characteristics of the 
character that follows them in a command so that that character 
"matches" as follows: 



Character 


Modifies the next character to: 


'% 


match anything except the character (s) 
normally matches 


it 


•7 


quote the next special character, or any 
character 


next 


•) 


match any number of occurrences of itself 





Special Replacement Characters 

You can use the following characters only in the new-string. 
These characters take the value of one of the special matching 
characters that you may have used in the existing-str ing . 



Character 


Can: 


1 II 

'7 


take the value of the characters matched by the 
nth special character in the existing-str ing 

take the value of the characters matched by the 
next sequential special character in the 
existing-str ing 

quote the next special character in the 
replacement-string or any next character 
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Restrictions 



SOS prints the following message when it tries to use an illegal 
combination of the above characters: 

%ILLEGAL SEARCH STRING 

If you give a very complex search string which requires an 
excessive amount of internal space, SOS prints the message: 

%SEARCH STRING TOO COMPLEX 



If SOS cannot find the existing string, it prints the message: 

%SEARCH FAILS 

and leaves your position at the current line. 

If you issue a Substitute command without an existing-str ing and 
there was no previous Substitute command, SOS prints the error 
message: 

%N0 STRING GIVEN 



If you specify an existing-str ing and new-string that together 
exceeds 200 characters, SOS prints the error message: 

%STRING TOO LONG 

You must then reissue the Substitute command with fewer 
characters in the existing-str ing and the new-string. 



Examples 



These two examples illustrate the Substitute command by replacing 
the word TIPE with TYPE in a file. 

This first example shows that after you typed the Substitute 
command once, it will continue the previous substitutions. 

I * , ^ 

*STIPE*TYF'E*10 dD 
00010 TYPE 101 

'I'S ( KH ) 

00020 101 FORMAT <' PLEASE TYPE A NUMBER*') 

00050 TYPE 103»X 

00060 103 FORMAT (' YOU TYPED THE NUMBER 'yF) 

00080 TYPE lOArXfY 

* 
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2. This second example shows a similar Substitute command, but uses 

the D option for the first substitution, then S to cover all 

other substitutions in the file. The E command ends the 
substitution. 

I I 

*STIPE*TYPE*10»D (JED 
00010 TYPE 101 



*S ( KET ) 

00020 101 FORMAT (' PLEASE TYPE A NUMBER.') 

OD 

00050 TYPE 103fX 

E 

* 

3. The following example illustrates the Extended Characteristics of 
the Substitute command using multiple strings of substitutions. 
The text file is printed (line 2100 and the next 5 lines) to show 
the results before and after the substitutions are made. 

*P2100!5CmD 



02100 


LINE A 


02200 


LINE B 


02300 


LINE C 


02^^00 


LINE D 


02500 


LINE E 


*GLINE A( R" ) 


LINE 


B ( RtT ) 


LINE 


C ( RET ) 


LINE 


D( RET ) 


LINE 


E*LINE Vfl^ 
t 


( 


LINE 


W ( RET ) 


LINE 


X ( RET ) 


LINE 


YCj!iO 


LINE 


Z*2100:2500rN»5( rh ) 
t 

, ESC ) _ 


( 


*P2100!5( R'T ) 


02100 


LINE V 


02200 


LINE W 


02300 


LINE X 


02400 


LINE Y 


02500 


LINE Z 


* 





4. The following Substitute command replaces the word THAT at the 
beginning of line 900 with the word THIS. Notice the '% (not) '/ 
(any character) matches the beginning of the line; (i.e., not 
any character THAT matches 00900 THAT since the line number and 
the tab are not part of the actual line contents) . 

*/C128 QeT) 
»P900 C^FT) 

00900 THAT METHOD CAN BE USEFUL. 
* S ' % ' /THAT* THI S* 900 C^D 
t t 

( "t ) C ESC ) 

00900 THIS METHOD CAN BE USEFUL. 
*/C64 (J^ 
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5. The next example illustrates the same special characters as the 
previous example does, but in a different content. The .'%'/ in 
the Substitute command represents "a period and not any 
character". Therefore, only the period at the end of the line is 
substituted with a serai-colon (;). (At the end of the line, 
there is "not any character" not even the space character.) 

«/C128C^D 

01900 THIS. METHOD* CAN. BE. USEFUL. 
*S. '%V*J*. GiD 

C tSt X ESC ) 

01900 THIS. METHOD. CAN. BE. USEFUL? 
* 

6. In the next example you switch the numbers before a 5, with the 
numbers before a 6. (period) on line 1600. The l')'/5 matches 1 
and any number of any character until a 5 is reached. The ')'/ 
matches all the characters from the comma after the 5 up to the 1 
in 1976. The l')'/6. (period) matches 1 and any number of any 
character until a 6. (period) is reached. Now, in the new 
string, •*3'* supplies the characters from the third pattern, 86; 
•*2'* supplies the middle characters, BUT NOT IN; (semicolon) 
and •*1'* supplies the characters from the first pattern 97. 

*/C128 CUD 
*P1600 Q^D 

01600 THEY WERE KNOWN WELL IN 1975r BUT NOT IN 1866. 
*S1') V5') '/I' )'/6.*l'*3'*5'*2'*l'*l'*6.*1600C«sD 

t t 

( tsc ) ( ES<. ) 

01600 THEY WERE KNOWN WELL IN 1865> BUT NOT IN 1976. 
*/C64 QIT) 
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5.24 TRANSFER - T COMMAND 

Function 

The Transfer command transfers a line or range of lines so the 
first line being transferred starts at the specified position or 
after the specified position (destination) . The Transfer command 
automatically deletes the specified line or range of lines from 
their original position in the file. 

Format 

*Tdestinat ion, source- range , first-page- inc , last-page- inc QiD 

Arguments 

destination is the starting line number (and page number, 

if different from the current page number) 
where the transferred lines will be placed. 
If this destination already exists, the 
transferred lines will start directly after 
this destination. 

, source-range is the range of source lines with or without 

page numbers that are transferred to the 
destination and then deleted from their 
original position in the file. 



Options 



,f irst-page-inc is the increment SOS uses to number the first 

page of transferred lines. All lines in 
succeeding pages (except the last page of the 
file) retain their line numbers. 

,last-page-inc is the increment SOS uses to number the last 

page of transferred lines. 



Special Cases 



If you specify an increment for the first page or last page that 
is incorrect or cannot be used, SOS will choose another increment 
and indicate that increment with the message; 

INC1= increment-number 

for the first page, and 

INC 2= increment-number 

for the last page. 
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If you do not specify an increment, SOS will create its own 
increment for the transferred lines. If the lines are 
transferred to the end of a file and you are using the SOS 
default of 100, the SOS prompt character (*) will be the only 
reply to indicate that the transfer was executed properly. If 
the lines are transferred to a destination between two existing 
lines, SOS will reply with a message to indicate that the 
transfer was executed properly: 

INC1= increment-number 

Hints 

SOS will create a page mark in the transfer execution only when 
the source-range contains a page mark. When you complete a 
transfer of a source range of lines including a page mark, your 
file may have additional page marks that are not needed. In 
actuality, the Transfer command causes SOS first to make a copy 
in memory of the source range and page marks (if specified) and 
then to delete the source range but not the page marks from the 
file. At this point, SOS makes the transfer to the specified 
destination from the memory source range. Thus, SOS may add page 
marks that are unwanted to your file, containing more than one 
page. 

Restrictions 

%TEXT INSERTED AT END OF FILE 

When this message appears, you have transferred a range of 
line/page numbers to the end of your file where no page marks 
exist for the contents of -the transferred lines. When examining 
your file after this message appears, you will find an additional 
page mark in your file that you may wish to delete (Kill 
command) . 

%INSUFFICIENT CORE AVAILABLE 

When this message appears, you have exhausted all available 
memory for the transfer. Reissue the Transfer command again 
using a smaller range of line numbers for the transfer and repeat 
the Transfer command until you transfer all the lines you want 
moved. 

% WARNING - COPY ASSUMED 

When this message appears, you have typed a Transfer command in 
the same format as a Copy command by specifying a source file or 
an /S. SOS assumes that you have decided to change the Transfer 
to a Copy command; i.e., to copy but not delete (the Transfer 
command cannot transfer from one file into another file) . If you 
receive the error message: %ILLEGAL COMMAND with the above 
message, you did not complete- the specifications of the Copy 
command. If you receive the INCl=nnnnn (nnnnn is an increment) 
message with the above message, you specified a correct filename, 
file extension, and source range and the Transfer command 
performed as if it were a Copy command. If you receive a C* with 
the above message, you may print lines within the file to find 
the source range to be copied to your file. (Refer to the Copy 
command for the correct command specifications.) 
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%OUT OF ORDER 

When this message appears, you have specified an increment for 
the transferred lines (any page) that is too large for the 
destination. SOS will choose another increment on its own and 
reply with the message INCl=increment; or, if the increment was 
for the last page, SOS will again choose another increment on its 
own and reply with the message INC2=increment . 

%ILLEGAL TRANSFER DESTINATION 

When this message appears, you have specified a destination for 
the Transfer command that cannot be used. An example of this 
error would be if you attempted to transfer the contents of an 
entire page to a nonexisting line number within the same page. 
You should examine your file and issue the Transfer command 
again, specifying a legal destination. 

Examples 

You have the following one-page file: 



00100 THIS IS THE LAST LINE OF TEXT* 

00200 THIS IS THE SECOND LINE OF TEXT* 

00300 THIS IS THE THIRD LINE OF TEXT* 

00400 THIS IS THE FIRST LINE OF TEXT* 
* 

1. By transferring the line 400 to the top of your file and then 
transferring line 100 to 400, you will place the file contents in 
its correct order. 

*T'^»400 (HD 
INC1=00050 

00050 THIS IS THE FIRST LINE OF TEXT* 

*T400»100 QeT) 

* 

Your entire file now appears in the following format: 

p/iCUD 

00050 THIS IS THE FIRST LINE OF TEXT* 

00200 THIS IS THE SECOND LINE OF TEXT* 

00300 THIS IS THE THIRD LINE OF TEXT* 

00400 THIS IS THE LAST LINE OF TEXT* 
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2. You attempt to transfer the contents of your file to a 
nonexisting line within the current page: 

*T600^/1 C^FQ 

/CILLEGAL TRANSFER DESTINATION 
* 

3. You transfer the contents of page 1 including the page mark to a 
destination specified as line number 100/2 (page 2) : 

*T100/2y/:l QE) 

%TEXT INSERTED AT END OF FILE 

* 

If you examine your file after the above command is executed, you 
see that your file now contains three pages because the Transfer 
command does not delete page marks, but only the source contents. 
The lines were transferred to page 3, not page 2. To avoid this 
result, specify the actual line numbers in the range with the 
appropriate page number. 

*p/i:/* C^-) 

PAGE 1 

PAGE 2 

PAGE 3 

00100 THIS IS THE FIRST LINE OF TEXT* 

00200 THIS IS THE SECOND LINE OF TEXT* 

00300 THIS IS THE THIRD LINE OF TEXT* 

00400 THIS IS THE LAST LINE OF TEXT* 

Since there is no page mark for page one, SOS creates a page mark 
for the transfer because the range specified the entire contents 
of page 1. The transferred range in memory has a page mark 
(created by SOS) and the destination specifies a page number that 
does not exist. SOS inserts a page mark for page 2 and then 
inserts the transferred range in memory into your file. Thus, 
when the Transfer command has finished, you will have two 
additional page marks. 
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You maintain a two-page file and issue a Transfer command to 
transfer the contents from line 100 on page 1 through line 300 on 
page 1 to a destination of the last line on page 2, specifying an 
increment of 15 for the transferred lines. 

♦p/i;/2 (jiD 



PAGE 1 






00100 


ONE 




00200 


TWO 




00300 


THREE 




PAGE 2 






00100 


FOUR 




00200 


FIVE 




00300 


SIX 




*t*/2t: 


100/1 :300/ir 15 


i( KIT ) 


*P"/"j) 


♦t/* ( «<:l ) 




PAGE 2 






00100 


FOUR 




00200 


FIVE 




00300 


SIX 




00400 


ONE 




00415 


TWO 




00430 


THREE 




* 







The contents of the first page (00100/1 through 00300/1) was 
transferred to the end of page 2. Since the range did not 
specify the entire contents of page 1 (/I) , SOS did not create a 
page mark for page 1, and a page mark for page 2 already existed 
in your file. 
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Vc 



5.25 INVERT - W, VL, VU COMMANDS 

Function 

The invert commands (VV, VL, VU) are optional SOS commands and 
must be assembled for your installation of SOS. 

The invert commands allow you to perform uppercase/lowercase 
inversion. That is, when you are editing your file, you can 
change all uppercase characters to lowercase characters, all 
lowercase characters to uppercase characters, or both inversions 
at the same time for any specified range of lines. 

Format 

*Vcrange (""rTT ) 

Arguments 

c must be a V, L, or U and must accompany the V 

command. 

V inverts lowercase to uppercase and uppercase to 
lowercase at the same time. 

L inverts uppercase characters to lowercase 
characters; ignores all lowercase characters. 

U inverts lowercase characters to uppercase 
characters; ignores all uppercase characters. 

range specifies the range of lines you want to invert. 

Restrictions 

If you specify a range of line(s) that do not exist, SOS prints: 

%N0 SUCH LINE(S) 

If you specify any character than a V, L, or U, SOS prints: 

% ILLEGAL COMMAND 
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Examples 



The following text file will be used to illustrate the invert 
commands: 

*P/l CED 

00100 ABCDEFGHIJKLMNOPQRSTUVWXYZ 

00200 

00300 sbcdef^hi Jklmnop«rstuvwKys 

00400 

00500 AsBbCcndEeFfGsJHhliJJKkLlMniNnOoPp 

* 

The following example illustrates the W command on line 500: 
*^'V500C^r) 

♦ psooGlD 

00500 oAbBcCdDeEfF^GhHilJJkKlLmMnNoOpP 
* 

As the example shows, all uppercase characters were inverted to 
lowercase characters and all lowercase characters were inverted 
to uppercase characters. 

The next example illustrates the VL command on line 100: 

*VL100G7r) 

*piooc«iD 

00100 sbcdef ahi Jklmnoparstuvwxyz 
* 

In this example, the VL command inverted all uppercase characters 
to lowercase characters. If there were any lowercase characters 
on line 100, they would remain lowercase. 

In this example, the VU command inverted lowercase characters to 
uppercase characters: 

*P300 CTTP ) 

00300 ABCDEFGHIJKLMNOPQRSTUVWXYZ 

* 

If any uppercase characters had existed in line 300, they would 
remain in uppercase. 
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W 



5.26 WORLD (SAVE-THE -WORLD) - W COMMAND 
Function 

The World command saves your file without ending the SOS session. 

Format 

*Wm:filespec QEl) 

Options 

ra is a modifier that can be either B, D, Q, S, or a 

combination of B and S. 

B suppresses creation, of a backup file with the 
extension Qxt; also suppresses the creation of a 
backup file with the extension Zxt if the /OLD 
option is set. 

D deletes both the original file (input to SOS) and 
your edited file (output from SOS) . 

Q quits so that all changes to the original file 
from the time of the last backup to the present 
are lost. 

S unsequences (that is, strips line numbers from) 
the output. file. 

:filespec is the file specification of the output 
(destination) file. This file specification can 
consist of the following: 

dev: f ilnam.ext [p,pn,sfdl , . . . ] <nnn> 

This argument is optional; if it is omitted, the 
current file is used. (Refer to Chapter 2, Giving 
Commands, for a complete description of these file 
specifications. ) 



Hints 



After the World command is finished saving your file, SOS prints 
the file specification enclosed in square brackets. 

By using the World command periodically while in SOS, you protect 
your files against power failures and other system crashes; or 
instead of issuing the World command, you may want to set the 
ISAVE and SAVE options to automatically backup your file. 

When you specify a file specification with the World command, 
further World commands default to that file specification. 
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But when the ISAVE or SAVE options are set, all auto-save backups 
default to any last specified filename and extension. 



Restrictions 



If you give the WD command, SOS will delete both the input file 
and the output file. At this point, SOS converts its mode to 
Input mode and creates a temporary file, nnnSOS.TEM (nnn is your 
system job number) . You can now input the contents of a new 
file, which will have a temporary filename and extension, or you 
can end the SOS session with the EQ command. (Refer to Chapter 
10 for additional information about temporary files and how to 
use them.) 

* WD CED 



input: dskc: 

00100 $ 

t 

* EQQtD 

* 

If you set the /UNSEQUENCE option and then give a W or WS 
command, SOS prints the warning message: 

[WARNING: SEQUENCE NUMBERS PRESERVED.] 

because the file is saved as it appears in its entirety. If you 
want to unsequence your file with the World command, give the WS 
command with the SEQUENCE option set (SOS default) . 

If you have not made any changes to the file since it was last 
saved, SOS prints the warning message: 

[NO CHANGES.] 

and changes just the date on your file. 

If you specify an existing file when you give the World command, 
SOS will ask for you to confirm the deletion of the existing 
file. The following message will appear: 

OUTPUT FILE EXISTS - DELETE? (Y OR N) : 

You must reply with either a Y (for Yes) or a N (for No) . You do 
not need to press RETURN after typing Y or N. SOS responds with 
the ES of YES or the of NO. If your reply is N, SOS asks for 
another name of the file: 

FILE: 

You must supply a new file specification. SOS will then save the 
contents of the edited file in the file you specify. 

In some conditions, the Qxt backup file may become 
write-protected. SOS ignores the wr ite-protection, creates the 
backup file and prints the message: 

%BACKUP FILE PROTECTED - IGNORED 
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If the file is protected and you cannot overwrite it, SOS prints 
the message: 

?FILE WRITE PROTECTED, TRY ANOTHER NAME 

FILE: 

after which you should type a new file specification. 

If you type an illegal file specification, SOS prints the 
following message: 

% ILLEGAL COMMAND 

Your file is not saved until you give a correct file 
specification. 

Examples 

1. You give a World command to save your file: 

cdskc:test,alg3 

2. You give a World command, but you have the /UNSEQUENCE option 
set, so you receive the warning message. 

cwarning: sequence numbers preserved ♦j 
cdskcjnxtfil.macc27r51073 3 

* 

3. You save your file without line numbers. 
*WS GTT) 

CDSKC: CHANGE. CBLC27y 2353 3 
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4. You save your file in another directory with a new name, but you 
do not have access privileges to that directory. 

*y : SAMPLE . TXTL-27 » 2353 QED 

%ILLEGAL COMMAND 

5. You now specify a directory that you do have access privileges 
to. 

*W : SAMPLE ♦ TXT 1:27 » 5307 J G03 

C DSKB : SAMPLE ♦ TXT C 27^5307 3 3 
* 

6. You give the World command, but you have made no changes since 
you last saved the file. 

W-W ( Kfr ) 

CNO CHANGES* 3 
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5.27 EXTEND - X COMMAND 

Function 

The extend command moves the pointer to the end of the line(s) 
specified and allows you to enter text to the end of the line(s). 
The line(s) may or may not be printed in their entirety depending 
on whether the ,S option is specified or not. You may press 
ESCape to enter Alter mode, or press RETURN to return to Edit 
mode and end the extension. 



Format 



*Xrange ,S ( k^t ) 



Argument 

range 

Option 



is the range of lines that you want to extend. 
When you indicate more than one line, SOS 
automatically proceeds to the next line. 



stops SOS from printing the line. Instead, SOS 
prints just the line number; anything you type 
from that point on is added to the end of the 
line. 



Operation 
1. 



Give the extend command; SOS prints out the entire line and 
leaves the pointer at the end of the line. 

*X500J700QED 

00500 THIS IS A TEST OF 



2. Type the characters you want to add to 
RETURN; SOS prints the next line. 

00500 THIS IS A TEST OF THE EXTEND C^TT 
00600 COMMAND AND 



the line and press 
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Type the characters you want to add or press ESCape to stop 
inserting characters and to be able to give Alter mode 
instructions. In this step, you press ESCape to enter Alter 
mode after mistyping the word ALTER. After correcting the 
word ALTER, you press RETURN and go on to the next line. 

00600 COMMAND AND ALTTER MODE* 

t 

GED L 

00600 COMMAND AND ALTWTWER MODE* 

t t 

2ST DQeT) 

00700 THIS IS LINE 



4. Last, you extend line 700 and end the range specified in the 
extend command. 

00700 THIS IS LINE 700 GE) 



Special Cases 



To insert new lines, press the Linefeed (LF) key instead of 
ESCape or RETURN; SOS prints a new line number. Type the line 
contents. Each extend command terminates only after you press 
RETURN. Refer to the example below. 



*X600CHiD 

00600 TYPE lOlQD 



When you gave the extend command, SOS 
printed the line, you typed 101 and 
pressed Linefeed. 



00650 101 FORMAT ('STARTING THE RUN.' 



SOS created a new line number, you typed 
an entire new line, and then pressed 



Linefeed. 
00675 TYPE 101 C^iD 



SOS created a second new line number. 
You typed this new line and ended the 
extend command by pressing RETURN. 
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Examples 

1. The following two examples illustrate the extend command without 
and with the S option: 

♦X100J200 ChT) 

00100 THIS IS LINE ONE FOR THE X COMMAND EXAMPLEQID 

00200 THIS IS LINE TWO FOR THE X COMMAND EXAMPLE QFT) 

* 



*X100J200»S GID 

00100 FOR THE X COMMAND EXAMPLE (T^ 

00200 FOR THE X COMMAND EXAMPLE QiT) 

*pioo:20oCIED 

00100 THIS IS LINE ONE FOR THE X COMMAND EXAMPLE 
00200 THIS IS LINE TWO FOR THE X COMMAND EXAMPLE 

2. The following example illustrates an extend command in which you 
enter Alter mode after extending the text line in order to 
recreate and correct text in the original line. 

*xsoo CUD 

00500 THIS IS AN XTEND XAMPLE WITH ALTER MODE/EDOM RETLA HTIW 

t 

( tS( ) ■" ( TAB ) 

ELPMAX DNETX NA SI SIHT\ 

00500 THIS IS AN EXTEND EXAMPLE WITH ALTER MODE 

f t f 

SX lEGE) SX lEQ^QiD 
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CHAPTER 6 
UPPERCASE, LOWERCASE, AND SPECIAL CHARACTERS 



When you start an SOS session with the SOS command and no options, the 
SOS program uses the following defaults: 

1. Terminal characteristics of the TOPS-10 SET TTY command 

2. /C64 and the TOPS-10 system default of M33 (UC) 

3. /BAK, /INCREMENT: 100, /LENGTH: 55, /LMAR:1, /MAXLN : 99999 , 
/NODECIDE, /NODELETE, /NONSEPARATORS , /NOVICE, /NUMBER, 
/PLINES:16, /PMAR:1, /RMAR:69, /SEQUENCE, /START: 100, and 
/STEP:100 

You can change the defaults by specifying options with the SOS 
command, by specifying them in your SWITCH.INI option file, or by 
setting them at the SOS command level (the M33 and M37 options are 
unique in that they can be determined by setting your terminal (SET 
TTY) to UC (uppercase) for M33 or to LC (lowercase) for M37) . 



6.1 SOS AND YOUR TERMINAL SETTING 

You can identify all of your terminal characteristics (parameters) by 
giving the TOPS-10 command INITIA TTY. 

The SOS program uses the terminal type set by the TOPS-10 command SET 
TTY UC or SET TTY LC . You can display this type on your terminal 
during SOS by giving the =CASE command. For SOS purposes, your 
terminal is either uppercase-only, M33 (VT05, VT06, VT50), or 
uppercase and lowercase, M37 (VT52, LA36) . Uppercase-only terminals 
respond to your commands in uppercase characters only. 
Uppercase-lowercase terminals respond to your commands in both 
uppercase and lowercase characters. Depending on your terminal type 
and characteristics and the options you set, all alphabetic characters 
that you enter as text to a file during an SOS session will appear in 
the format and case you specified. 
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6.2 TERMINAL TYPE: UPPERCASE-ONLY 

A terminal with uppercase type only, such as a VT05 terminal, can 
still make use of the lowercase argument of the SET TTY command. 

On a VT05 terminal when SET TTY LC is in effect, you use the SHIFT key 
with letters you want to be uppercase; that is, you type as if using 
a conventional keyboard. All alphabetic characters will appear as 
uppercase on the terminal screen, but when printed or listed on the 
line printer, the text will appear in uppercase and lowercase as you 
typed it. 

A VT50 terminal displays all alphabetic characters as uppercase. If 
you set your VT50 terminal to lowercase (SET TTY LC) , it will have no 
effect. To enter lowercase characters in an SOS session using a VT50 
terminal, you must set the /LOWER and /C128 options to have the 
characters appear as lowercase when printed on the line printer. 



6.2.1 Typing Uppercase On Uppercase-Only Terminals 

To type uppercase characters into a file from an uppercase-only 
terminal is, of course, the simplest input task. The ordinary SOS 
default settings suffice; you do not have to set any options when you 
start the SOS session (/C64 and /UPPER are set by default) . If the 
file you are working with already has lowercase characters in it, they 
appear as uppercase characters on the terminal screen. 

» SOS UF'F'ER.iXTCiD (using a VT50 terminal) 

edit: upper ♦TXT 

* ^^-"CASE QiD 
C64 UPPER 

* 1600 C «tT ) 

00600 THIS IS AN UPPERCASE-ONLY EXAMPLE* GID 

00700 $ 
t 



* P600 CJiD 

00600 THIS IS AN UPPERCASE-ONLY EXAMPLE. 
*L600 QiD 



In this example, you start SOS on a uppercase-only terminal, insert 
line 600, print it on your terminal, and use the List command to print 
it on the line printer. All characters are uppercase. The line 
appears on the line printer as: 

00600 THIS IS AN UPPERCASE-ONLY EXAMPLE. 
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6.2.2 Typing Lowercase On Uppercase-Only Terminals 

To type only lowercase characters into a file on an uppercase-only 
terminal of the VT50 type, set both the /LOWER and /C128 options. For 
the VT05 type terminal, you need only set your terminal to lowercase 
with the SET TTY LC command at TOPS-10 command level. The characters 
will appear as uppercase when entered and printed on the terminal; 
but when the text is printed on a line printer that has a lowercase 
character set, the characters will be lowercase. 

In the example below, you can create the file LOWER.TXT with one line 
of all lowercase characters. 

♦SET TTY LC QiD (using a VT05 terminal) 

.SOS LOWER. TXT GID 

input: LOWER.TXT 

00100 THIS LINE IS ALL LOWERCASE CHARACTERS . QiD 

00200 $ 
t 



t;DSKCJLOWERvTXT:;i 

)KL100 CIKy 

* 

The line appears on the line printer as: 

00100 this line is all lowercase characters. 

Remember, to enter both uppercase and lowercase characters into a file 
from a VT50 terminal, set the /C128 and /LOWER options; from a VT05 
terminal use the SET TTY LC command. 
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You can create a text line in the UPPER.TXT file using the /UPPER 
option default and specify the /C128 option. With the /UPPER and 
/C128 options set, the single-quote character (') indicates that the 
following character is lowercase (it is said to "quote" the next 
character); SOS sees the two characters as one lowercase character. 

♦S0S/C128 UPPER* TXT CED (using a VT50 terminal) 

edit: upper* TXT 



*R100C^iD 

00100 T'H'I'S 'I'S 'A'N UPPERCASE-ONLY 'E ' X ' A'M 'P'L 'E . GlL 

1 LINES (100/1) DELETED 

00200 



*=CASE QiD 
MODEL 37 UPPER 

*P » C RET ) 

00100 T'H'I'S 'I'S 'A'N UPPERCASE-ONLY 'E 'X ' A 'M ' P'L 'E ♦ 

If you reset the /C64 option after the line has been entered with the 
/C128 option in effect, all characters on the text line will appear in 
uppercase on an uppercase-only terminal without single-quote 
indications. 

*/C64 GiD 

*P* CT^ 

00100 THIS IS AN UPPERCASE-ONLY EXAMPLE ♦ 



*L100 CUD 

When the line is listed on the line printer, the line appears as: 

00100 This is an UPPERCASE-ONLY example. 

You can specify the /LOWER option with the /C128 option on an 
uppercase-only terminal. With these two options set, the single-quote 
character (•) indicates that the next character is uppercase and SOS 
sees the two characters as one uppercase character. 



6-4 



UPPERCASE, LOWERCASE, AND SPECIAL CHARACTERS 

In the example below, you edit the file UPPER, TXT by inserting line 

number 200 with the /C128 option specified in the SOS command and the 

/LOWER option set at SOS command level. (SOS will recognize the 
/LOWER option setting only at SOS command level.) 

♦S0S/C128 UPPER ♦TXT QeT) (using a VT50 terminal) 

edit: upper ♦TXT 

* /LOWER CEiT) 

* ^-CASE QiT3 
LOWER 

* 1200 C^T) 

0020C 'THIS IS AN ' U ' P ' P ' E ' R ' C ' A ' S ' E- ' ' N ' L ' Y EXAMPLE ♦ C^TT) 

00300 * 
t 

GiD 
*p» 



00200 'THIS IS AN 'U ' P'P 'E 'R 'C ' A 'S'E- '0 'N'L ' Y EXAMPLE* 

On a line printer, line 00200 would appear as: 

00200 This is an UPPERCASE-ONLY example. 

By resetting the /C64 option, all characters on the text line appear 
in uppercase on an uppercase-only terminal without single-quote 
indications; but when listed on the line printer the text line 
appears in its proper format as follows: 



* /C64 ( "ET ) 

♦ P ♦ ( RET } 

00200 THIS IS AN UPPERCASE-ONLY EXAMPLE* 
5»L200 GlD 

This is an UPPERCASE-ONLY example. 
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6.3 TERMINAL TYPE: UPPERCASE-LOWERCASE 

An uppercase-lowercase terminal (VT52 or LA36) can display all 
alphabetic characters in both their uppercase and lowercase format. 
If you set your uppercase-lowercase terminal to lowercase (SET TTY 
LC) , you can input alphabetic characters into a text file the same way 
as you would with a typewriter. By pressing the SHIFT key, you type 
uppercase characters. Thus, all alphabetic characters will be 
lowercase unless you press SHIFT and type the character. 

For SOS purposes, you do not need to set any SOS options when you use 
the command SET TTY LC. The uppercase-lowercase terminal gives you 
the option of either uppercase-only or uppercase and lowercase, and 
you do not have to change the SOS default options of /C64 and /UPPER. 



6.3.1 Typing Uppercase On Uppercase-Lowercase Terminals 

To type uppercase characters on an uppercase-lowercase terminal, set 
your terminal to uppercase (SET TTY UC) and start SOS without 
specifying any of the SOS options, just as if the terminal were 
uppercase-only. The /C64 and /UPPER options are set by SOS default. 
Any lowercase characters already in a file will appear as lowercase 
characters on the terminal. 

»SET TTY UC GiD (using a VT52 terminal) 

♦SOS UPPER.TXT GED 
Edit: UPPER*TXT 

*I200 QiC' 

00200 'HIS IS AN UPPERCASE ^EXT LINEGlD 
00300 ON AN UPPERCASE-LOWERCASE TERMINAL* GHD 



00400 




Fa^e i 

00100 this text line is 3ll lowercase characters* 

00200 THIS IS AN UPPERCASE TEXT LINE 

00300 ON AN UPPERCASE-LOWERCASE TERMINAL* 

* 

When printed on the line printer or typed on the terminal, the file 
appears as follows: 

♦ T- Y F- E U F' "=■ E A * ' X T .C^C 

00100 this text line is all lowercase characters* 

00200 THIS IS AN UPPERCASE TEXT LINE 

00300 ON AN UPPERCASE-LOWERCASE TERMINAL* 

If your terminal is not set to lowercase (LC) , the file would still 
appear in the above format on an uppercase-lowercase terminal. 
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6.3.2 Typing Lowercase On Uppercase-Lowercase Terminals 

To type lowercase characters into a file on an uppercase-lowercase 
terminal, specify the TOPS-10 command SET TTY LC before starting your 
SOS session. You do not have to set any SOS options to enter 
lowercase characters into a file on an uppercase-lowercase terminal. 
All alphabetic characters you type will be in lowercase. By pressing 
the SHIFT key, alphabetic characters can be entered as uppercase. 
When printed or listed on the line printer, the characters will appear 
as you typed them. 

♦SET TTY LC QeD (using a LA36 terminal) 

♦ SOS. lower* txt QtT) 

Edit: LOWER ♦TXT 

)|t"-case ( KFT ) 

Model 37 C64 Ur-per 

*i200 CHiD 

00200 this line is all lowercase characters* C^fT) 

00300 $ 

cfc) 

* 

When the above text line is listed on the line printer, it will appear 
as: 

00300 this line is all lowercase characters. 



6.4 TYPING SPECIAL CHARACTERS 

Special characters can be alphabetic, numeric, or punctuation 
characters; they must be preceded with the single-quote character 
('). All special characters that are typed into a file or used in the 
SOS Substitute command must be used with the /C128 option set. Unless 
the /C128 option is set, SOS does not see the two characters as one 
character, but as two. 

When entering numeric and punctuation special characters during an SOS 
session, no SOS option will have an effect on the special characters 
except the /C64 option, which reverses the /C128 option; the /LOWER 
and /UPPER options only affect the alphabetic characters. 

Table 6-1 lists the control characters with their American National 
Standards Institute (ANSI) name, their /C128 representation, and their 
meanings, if applicable, when used in SOS commands or command files. 

NOTE 

Because SOS is a line-oriented editor, 
you cannot enter into your file any 
special characters for linefeed and 
carriage return. 
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Table 6-1 
Control Characters and Their /C128 Representation 



Control Character 


/C128 


Meaning 


and its ANSI name 


Representation 


(if applicable) 


'*A (SOH) 


• 1 


Match any letter (A-Z, a-z) 


"B (STX) 


• II 


Next match string 


'*C (ETX) 


'# 




''D (EOT) 


•$ 




'^E (ENQ) 


■% 


Not next character (Search) 


''F (ACK) 


•& 


Match any uppercase (A-Z) 


"G (BEL) 


•\ 


Abort (for Inserts) 


"H (BS) 


'( 


Backspace - also deletes 


'^N (SO) 


') 


Zero or more of next char. 


"0 (SI) 


I * 


n'th match string 


"P (DLE) 


• + 


Any decimal digit (0-9) 


"Q (DCl) 


1 




"R (DC2) 


1 _ 




"S (DC3) 


1 

• 




''T (DC4) 


V 


Matches any character 


"U (NAK) 


•0 




"V (SYN) 


'1 


One or more of next char. 


'*W (ETB) 


•2 


Match any lowercase (a-z) 


'*X (CAN) 


•9 


Match any alphanumeric 


**¥ (EM) 


'6 




"Z (SUB) 


'4 




" [ Escape 


1 _ 


ESCape from input mode 


''\ (FS) 


•< 


Matches space or tab 


'*] (GS) 


•> 


Matches end of line 


"'' (RS) 


•7 


Quote next character 


'* (US) 


'8 




^ Accent Grave 


•@ 




{ Left curly brace 


'[ 




1 Vertical bar 


1 . 




} Right Curly brace 


■i 




~ Tilde 


'3 




• DEL 


1 1 


Character delete 



(Refer to Appendix C for a complete special-character 
ANSI names and abbreviations.) 



table and all 
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CHAPTER 7 
SPECIAL CHARACTERS IN FIND AND SUBSTITUTE COMMANDS 



In some instances, you may be required to edit a large or complex 
file, where the Find and Substitute commands with the /C64 option set 
require changes to the existing-string argument. For this reason (and 
possibly others) , you may choose to enter special characters in the 
Find and Substitute commands to give them additional power and 
versatility. You must set the /C128 option before using the special 
characters. (Table 6-1, Special Characters, gives a list of special 
characters available to you. Refer to Appendix C for all available 
special characters and their ANSI names and abbreviations.) 



7.1 COMMAND FORMAT DEFINITION 

As shown in Chapter 5, the Find command has the following format: 
*Fex is ting-st rings range, A, N,E, number QiD 

and the Substitute command has the following format: 

*Sexistin.-string|„e„-st.ing?.ange,0,«,E,nu.berGD 



Special characters can be used in the above formats. 

1. You can use special "matching" characters instead of the 
exact characters for the existing-string contents of the Find 
and Substitute commands. 

2. You can use special "replacement" characters instead of exact 
characters to match characters from the existing-string 
contents of the Substitute command. 

Thus, the Find and Substitute command formats can also appear as 
follows: 



and 



*Fmatch-string$range,A,N,E, number QH 



*Smatch-string$replacement-string$range,D,N,E, number Ci^iT) 

C ESC ) ( ESC ) 
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7.2 SPECIAL MODE - /C128 

When you start the SOS program, the /C64 option, the SOS default, is 
set. This option is adequate for most applications. If you desire to 
use any special characters in a file, such as matching and replacement 
characters or special control characters, you must set the /C128 
option. 

The /C128 option, when set, allows you to enter any of the characters 
from the complete ASCII 128-character set, except for carriage return, 
line feed, and null. All special characters (matching characters, 
replacement characters, and control characters) are indicated by a 
single-quote character (') plus a punctuation, alphabetic, or numeric 
character. An alphabetic character with a single quote preceding it, 
for example, indicates an uppercase character (if the /LOWER option is 
set) or a lowercase character (if the /UPPER option is set). Another 
example is '" which appears to SOS as CTRL/B, STX (start of text). 



In summary, when the /C128 option is in effect, SOS interprets the 
single-quote character and the following character (punctuation, 
alphabetic, or numeric) as a single character. 



7.3 SPECIAL MATCHING CHARACTERS 

Special matching characters can be used in both the Find and 

Substitute commands to match any of the characters that exist in the 

text of a file. Special matching characters are in two groups as 
follows: 

1. Special characters that represent any single character in the 
file contents without a character specification following the 
special character. 

2. Special characters that represent any string of characters in 
the file contents with a character specification following 
the special character. 

With these two groups, you can issue Find and Substitute commands to 
determine different text strings of characters that have some similar 
features or positions within a file. 

These two groups, their representation, function, and examples with 
descriptions appear in the next two sections. 
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7.3.1 Character Match, Without Character Specification 

The following special characters match single characters: 



/C64 
Character 


/C128 
Mnemonic 


Matches 


''T 

1 (vertical 
bar) 


V 


any single character 

any single separator, that is, any 
character other than a letter, number, 
period (.), percent (%) , or 
dollar-sign ($) 



(For the ANSI names and abbreviations of the /C64 characters, refer to 
Tables C-1 and C-2 in Appendix C.) 

Examples using the /C128 mnemonics: 

1. You replace any character ('/) in the line number 1200 with an X. 

*P1200 (JtT) 

01200 ABCDEFGHIJKLMNOPQRSTU^^WXYZ 

*/C128 QlD 

* s ' /* X* . 'CZlD 

t t 



01200 



xxxxxxxxxxxxxxxxxxxxxxxxxx 



You replace any three characters followed by a period (.) and the 
period itself, since it too is in the match-string, with the word 
TWO. for lines 300 through 500. 

♦•/C128 GiD 
>KP300i 3 CItT) 

00300 THIS IS LINE THF^EEr PAGE ONE* 

00400 THIS IS LINE FOUR r PAGE ONE. 

00500 THIS IS LINE FlK>Ef PAGE ONE ♦ 
>KS V'/'/»$TW0»*300!3 QID 

t t 



00300 
00400 
00500 



THIS IS LINE THREE » PAGE TWO 
THIS IS LINE FOURt PAGE TWO 
THIS IS LINE FIVEr PAGE TWO 



You replace any two separators, in this case two slashes (//) , 
with a comma and a space on the current line in a file. 

*/C128GlD 

>K I"' ♦ ( RLT ) 

00100 YOU CAN INSERT//DELETE//OR PRINT LINES// 



:4> , 4 » ( Rn 



00100 



YOU CAN INSERT T DELETE » OR PRINT LINES r 
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7.3.2 Character Match, With Character Specification 

The following special characters match single or multiple occurrences 
of characters when specified with a character or special character. 



/C64 
Character 


/C128 
Mnemonic 


Meaning of Character 


''N 


•) 
'7 


not the character following this 
special character 

arbitrary number of; any number of 
occurrences of itself; must only be 
used with another special character 

quote next character; quote any 
special character that may be used in 
a file or any string of characters 



(For the ANSI names and abbreviations of the /C64 characters, refer to 
Tables C-1 and C-2 in Appendix C.) 



Examples using the /C128 mnemonics: 



1. This example illustrates a substitution of an A: for 
occurrence of an A and a separator that is not a colon (:). 



any 



3t(F'750 ( . KET 

00750 A»B AfC A?D AJB AtC A!D A$B A&C AQH 
*/C128 CED 

#sa'x:*a;*750 q^ 

t t 

QsT) ( ESC ) 



007500 a:b a:c ajd a:b a;c ajd a:b a:c a:d 
* 

The next two examples illustrate a special feature of the character 
'%. The first substitution replaces THIS for the occurrence of THAT 
at the beginning of the line only. The second substitution replaces 
THIS for the occurrence of THAT at the end of the line only. The '% 
(not) •/ (any character. Section 7.3.1) when used in this way will 
match the beginning or ending of a line. 

2 . *P600 : 700 G^D 

00600 THAT NEWEST METHOD IS USEFUL? THAT 

00700 CAN BE COMPLEX* 

*/C128C«iD 

*S ' % ' /THAT$THIS$600 QiD 

t t 

GE3 (JED 



00600 
* 



THIS NEWEST METHOD IS USEFUL? THAT 



and 
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*P600 "^^ 

00600 THAT NEWEST METHOD IS USEFUL? THAT 

*STHAT'%V*THIS|600 C^FT ) 



00600 THAT NEWEST METHOD IS USEFUL? THIS 
* 

You replace the word STRUCTURE for the word TREE on line number 
300 on page 1. The Substitute command specifies that an S and 
any arbitrary number of any characters ending with E will be 
replaced with TREE. 

*P300/i GnD 

00300 THE FORK STRUCTURE MAY BECOME COMPLEX* 

*/C128 (^£> 

* SS ' ) ' /E* TREE* ♦ CUD 

t _L 

ESC 



00300 THE FORK TREE MAY BECOME COMPLEX* 
* 

If this Substitute command were given for a large file Containing 
many words that begin with S and contain an E, the word TREE 
would replace all occurrences as shown below: 

*P500 QID 

00500 SAVE» SINGLE r SUBSTITUTE t SAMPLE r SPACE 

*/C128GeD 

*SS') VE|TREE| , GID 

C tsc ) ( bSt ) 

00500 TREEy TREE» TREEr TREEr TREE 

It is important, therefore, that you understand the effects of 
the special character ') (any arbitrary number of) when used with 
another special character in a Substitute command. 

This example illustrates any arbitrary number of the separator 
semicolon being replaced by a comma (,). 

*P300/2 GnD 

00300 YOU CAN INSERT? DELETE? OR PRINT LINES* 
*/C128 GiD 
5KS' )':?*,$♦ CEnD 
t t 

00300 YOU CAN INSERT f DELETE r OR PRINT LINES* 
* 
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6. In this example you must switch '7 and the two up-arrows ("") on 
line number 100. The '7 '7 quotes the special character '7 in the 
text line. This text is again used in Section 7.4 to illustrate 
the "quote next character" ('7) in the replacement string. 



*/C128GiD 

*P1100 G^D 

01100 THE '7 IN /C64 IS THE SAME AS 

*S'7'7 GiD 

' '7M100 QiD 



IN /C128, 



01100 THE 
*/C64 C^TT ) 

*P. ( RET ) 

01100 THE 
* 



IN /C64 IS THE SAME AS 



7 IN /C128. 



IN /C64 IS THE SAME AS '7 IN /C128. 



7.4 SPECIAL REPLACEMENT CHARACTERS 

Special replacement characters allow you to take a pattern of matched 
characters, as specified by the special match characters in the 
match-string, and replace them in the text line(s) of a file without 
retyping them. The following special characters may be used only in 
the replacement-string of the Substitute command, with the exception 
of the '7 character which may be used in both the match-string and the 
replacement-str ing : 



/C64 
Character 


/C128 
Mnemonic 


Takes the Value of 


'^On'^0 


1 II 

'*n'* 
'7 


the characters matched by the next 
sequential special character in the 
match-string . 

the characters matched by the nth 
special character in the match-string. 

quotes the next character; next 
character may be a special character 
or a string of characters. 



(For the ANSI names and abbreviations of the /C64 characters, refer to 
Tables C-1 and C-2 in Appendix C.) 

The examples use the /C128 mnemonics. The example below illustrates 
the contents of the three lines of text being changed. The '" special 
character in the replacement-string will replace any single character 
represented by the '/ special character in the match-string for each 
text line. 
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*P1400!3 ChfT) 
01400 
01500 
01600 

*STEMPA+V*' " 
t 



PTRi: TEMPAflJ 

PTR2: TEMPA+2f 

PTR3: TEMPA+3J 

+ TEMPA*1400:i600GID 

t 



01400 
01500 
01600 
* 



PTRi: IfTEMPA? 
PTR2: 2+TEHPAJ 

PTR3: 3+tempa; 



In the example below, the words DOG and FOX must be reversed in the 
text line. The '" special character in the replacement-string 
specifies the pattern of characters from the match-string as specified 
by the ')'/ special characters (which represent any arbitrary number 
of any character) . 



*/C128 CET) 

*P100 QIT) 

00100 THE QUICK BROWN DOG JUMPED 0^/ER THE LAZY FOX* 

*SDOG ' ) ' /FOXf F" OX ' " DOG* ♦ CED 

00100 THE QUICK BROWN FOX JUMPED OVER THE LAZY DOG* 



You can also change this text line using special character 
the replacement-string as shown below: 



m 



*/C128 CiD 
*pioo (3173 

00100 THE QUICK BROWN DOG JUMPED OVER THE LAZY FOX* 
*SDOG' ) VFOX|FOX'*l'*DOG|*GiD 

( t.SC~) ( LS( } 

00100 THE QUICK BROWN FOX JUMPED OVER THE LAZY DOG* 
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The following diagram illustrates the pattern of characters that 
replaces the matched pattern of characters: 



DOG 




JUMPED OVER THE LAZY 



\ 



FOX 



$ 
f 

GE3 



FOX 



DOG 



$ ( RET ) 

t 



The special replacement characters •*1'* could also be '". 

The example below shows the same text line and a more complex 
Substitute command with special characters. The 'b' character 
represents a space. 

*P100 O^iD 

00100 THE QUICK BROWN DOG JUMPED OVER THE LAZY FOX* 
*/C128 fiiir) 

*S') VD') Vb') VF' ) '/.*"F'*4'*b'*3'*D/*2'*»$100QF;) 

t t 

( ESC ) C ESC ) 



00100 

* 



THE QUICK DROWN FOX JUMPED OVER THE LAZY DOG* 
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The following diagram illustrates | the pattern of characters that 
replaces the matched pattern of characters: 



THE QUICK BROWN D 



ii> 



/D 



0Gb 

)'/b 



JUMPED OVER THE LAZY F 
')'/F 



OX. 



THE QUICK BROWN F 
inp 




(esc) 

\ 

$ 



OXb 
'M'*b 



JUMPED OVER THE LAZY D 
•*3'*D 



OG. 
I *2l« 



C ESC ) 
i 

$ C »" ) 



In the example below, the text line contains the special character '7, 
which must be reversed with the two up-arrows ("") . The '" special 
replacement character takes the value IN /C64 IS THE SAME AS, and the 
'7 '7 quotes (or places) this special character at the end of the 
replacement-string . 

*/C128 CEiD 
*P1200 CUD 
01200 THE '7 IN /C64 IS THE SAME AS -^^ IN /C128. 

*S'7'7' ) v'""'!'"'"'" '7'7|1200CRir) 

r^ ( ESC ) 
01200 THE -^^ IN /C64 IS THE SAME AS '7 IN /C128* 

The '7 special character's main purpose is to quote any special 
characters used in a file; but it may quote and also replace any 
character in /C128 mode. 
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In the example below, the characters Y and X are reversed. 

*/C128 CTFP ) 

«P80 C«^ 

00080 TYPE 104<Y»X)f 



00080 
* 



TYPE 10A<XfY)i 



The following diagram illustrates the pattern of characters that 
replaces the matched pattern of characters: 











( ts. ) 


Y, 




X) 


1 


')'/, 




')'/) 


$ 




I 

$ CiT) 



The first pattern of characters '*i'*( is TYPE 104 (, the second 
pattern of characters '*2'*) is Y, and the third pattern of characters 
'*3'*, is X. 
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The example below illustrates a Substitute command using special 
matching and replacement characters that will replace any pattern of 
characters on a text line with the matched pattern, eliminating all 
trailing spaces from the line. Null strings of spaces will not be 
removed. The 'b' character represents a space. 

*r' ♦ ♦ (^ RET j 

00100 THIS IS LINE ONE* 

00200 THIS IS LINE TWO » 

00300 THIS IS A NULL STRING: 

00400 THIS IS LINE FOUR* 

* 

Line numbers 100, 200, and 400 contain ten trailing spaces as can be 
shown with the Alter command below: 

*A100 (TeT) 

00100 THIS IS LINE ONE* 

"t t 

13SCID QiD 

*/ci28 GED 

*S'%bb' )b '%'/*' 



GK) 



00100 


THIS 


IS 


LINE 


ONE » 


00200 


THIS 


IS 


LINE 


TWO* 


00400 


THIS 


IS 


LINE 


FOUR * 


*F"':>K 


(Rtr) 








00100 


THIS 


IS 


LINE 


ONE* 


00200 


THIS 


IS 


LINE 


TWO* 


00300 


THIS 


IS 


A NULL string: 


00400 


THIS 


IS 


LINE 


FOUR * 



If you perform the same Alter command on line number 100, the pointer 
will be placed after the period (.). 

*A100 (T^ 

00100 THIS IS LINE ONE* 

t t 

13SCslD C "" ) 

* 

The special characters '%bb')b'%'/ in the match-string represent the 
last nonspace character and any trailing spaces. The special 
character '" in the replacement-string represents the matched last 
nonspace character of the line. 

This form of the Substitute command is useful for saving space when 
storing files within a directory. 
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CHAPTER 8 
LINE CONTENTS SPECIFICATIONS 



To reference the contents of a line in an SOS file, you usually use 
the line number and/or page number. SOS formats, for example, use the 
words "position" and "range" which refer to line numbers. 

However, there is another way to reference a line or lines. You can 
use the contents of the line(s) instead of the line number (s). One 
advantage of this technique is that it gives you a choice when you 
work with unsequenced files, i.e., files stored without line numbers 
to save storage space. You can resequence the file and use line 
numbers or you can use the line contents directly. 

This method for editing your file is most useful when your file 
contains more than 99,999 lines (the /MAXLN option default value) and 
you do not wish to create new pages for additional input or for 
editing. 



8.1 LINE CONTENTS COMMAND FORMATS 

The SOS commands have a different command format when you specify line 
contents instead of line/page numbers: 



QiT) 

*any-SOS-command$start-here$ ( ret ) 

:$f inish-hereS ( ret ) 



Arguments: 



start-here is a string of characters in the line where 
the SOS command will start its operation. 
The first occurrence of the string after the 
present position will be used. If the string 
start-here is not found, SOS prints the 
message: %N0 SUCH LINE(S). 

finish-here is a string of characters in the line where 
the SOS command will end its operations. If 
the string finish-here is not found, SOS 
prints the message: %N0 SUCH LINE(S) and no 
action is taken. 
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If only the string start-here is specified, the range contains one 
line, the one that contains the characters of start-here. The command 
format takes the form: 

(JED QiD 

I T 

*any-SOS-command$start-here$ dtD 

You may also combine line contents specifications and the regular 
line/page-number specifications in the SOS command to specify the 
range to search for the start-here string. The command format takes 
the form: 



nd§start-here$ Q 



*any-SOS-command$start-here$ CUD 

;line/paqe-number ( ret ) 

(Notice that the line/page-number follows the colon.) 

When you use line contents specification, the pointer will only move 
forward through a file. To move the pointer backward through a file, 
an additional argument, line/page number, must be specified after the 
start-here<ESC> and before the <RET>. The command format takes the 
form: 



( fcS( ) 



*any-SOS-command$ start-here? li ne/p age-number C "^t ) 
: $ f in ish-her e$ CreT) 

C«D 

The character string f inish-here<ESC> may be followed by a 
line/page-number argument in this command format or it may be omitted. 
The line/page-number (/I and /2 used in examples) is useful when you 
are not sure of your current position relative to the end of the file, 
since it guarantees the entire file will be searched. 



8.2 LINE CONTENTS SPECIFICATION EXAMPLES 

Line contents specifications are somewhat more complex than 
line/page-number specifications, but they may be helpful when you are 
editing large files. The following examples illustrate some of the 
SOS commands that use line contents instead of a range specification. 
An explanation follows each example. 
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1. 



A * 






*P ONE* 


( «tT ) 




J«TEN*( KET ) 










( «" ) 






00100 


LINE 


ONE 


00200 


LINE 


TWO 


00300 


LINE 


THREE 


00400 


LINE 


FOUR 


00500 


LINE 


FIVE 


00600 


LINE 


SIX 


00700 


LINE 


SEVEN 


00800 


LINE 


EIGHT 


00900 


LINE 


NINE 


01000 


LINE 


TEN 


* 







You issue a Print command showing the file that will be used in all 
the examples. 

2 . ( hS( ) C tsc ) 

:*TEN*/1 rrrn 



*C' 



r*ONE*/lQ£) 



:*Twof/i GK 



C^ 



*P*TEN*/1 r^IT^ 

J/1 GiD 

01000 
01100 
01200 



LINE TEN 
LINE ONE 
LINE TWO 



For demonstration purposes, you issue a Copy command, copying the 
first two lines of text and placing them at the end of the file. When 
the pointer is at the end of the file (as a result of the Copy 
command) , the /I specification (with the line contents specification 
format) is needed to force SOS to look through the entire contents of 
the file. 
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F'isixl/i C^D 



00600 LINE SIX 

C ESC ) ( E« ) 

nnHisixl/iC^D 



( ESC ) ClsT) 

*F4sixi/2 

00600 LINE BIX 



You mark a page mark for page 2 on the line that contains the word SIX 
as contents. 

4. cionjo 

*»*0NE*/1 GE) 



'!' 



You move the pointer (. command) to the line at the beginning of the 
file where the word ONE exists. 

5 . (esc ") C fscl 

PAGE 2 

iEIGHT| CED 

( E« ) ( ESC ") 

CjID 

00700 LINE SEVEN OF TEXTGhD 
00800 LINE EIGHT OF" TEXTQeT) 
* 

You issue an extend command for a range of lines that contain the word 
SEVEN through EIGHT. SOS prints PAGE 2 indicating that word SEVEN, at 
the beginning of the range, was found on page 2. 

Whenever you issue an SOS command using line contents as a range 
specification, SOS takes the command, after you press RETURN the first 
time, as if a Find command were issued. If the contents cannot be 
found, SOS types the message %N0 SUCH LINE(S). 
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8.3 LINE CONTENTS SPECIFICATION IN THE SUBSTITUTE COMMAND 

The Substitute command with the line contents range specification 
takes the form: 

( ESC )( ES( ) ( ESt ) 



( ESt ) ■ ( ESC )( ESt ) QsT) 

ng$new-string9$start-here$CRET 



*Sexisting-string$new-string$$start-here$CEI73 
:$f inish-here$ 
I t 

This format establishes a range of lines. 

An additional feature of this Substitute command exists when line 
contents are specified. You can specify up to three boundaries for 
the substitutions to execute in the contents of your file. (Refer to 
the last two examples in this section, for a description of how these 
boundaries are used. ) 

( ESC ) C ESC ) ( ESC ) ( ESC ) 

*Sexisting-string$new-string$$start-here$CKiD 

This format establishes a range of one line only. 

In either of the two Substitute command formats shown above, the 
substitute options or line numbers or both may be specified at the end 
of the command. 

With the file used in the previous section of this chapter, the 
following examples illustrate the Substitute command with line 
contents as a range specification. 

1. You substitute the word ELEVEN for the word TEN on a line that 
contains the word TEN. 

( ESC ) C ESC ) 

*STENtELEVENi*TEN* GsD 
t t 

( E5C ) ( ESC ) 

QeT) 

01000 TEXT ELE^^EN 

* 
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2. When you use the original file, you substitute the word TEXT for 
all occurrences of the word LINE. The line contents 
specification (i.e., the "range") is from the line that contains 
ONE to the line that contains TEN. (Another explanation of the 
range from ONE to TEN is to call it a "boundary" if this file 
were to expand many lines or many pages.) The substitute option 
number is specified to force the substitution to occur ten times. 



i i \ 
*SLINE$TEXT*$0NE$/1 

t 



( tst ) ( tS( ) 

i i 

:$TEN*» 






10 ( RET ) 


( "^1 ) 






00100 


TEXT 


ONE 


00200 


TEXT 


TWO 


00300 


TEXT 


THREE 


00400 


TEXT 


fouf;; 


00500 


TEXT 


FH^E 


00600 


TEXT 


SIX 


00700 


TEXT 


SEVEN 


00800 


TEXT 


EIGHT 


00900 


TEXT 


NINE 


01000 


TEXT 


TEN 


* 







In the next example, you issue a Substitute command with three 
boundaries as specifications for the range the substitution will 
execute in. When your file is extremely large and you are 
editing without line numbers, this Substitute command is useful 
when you want to explicitly set the range (boundary) for the 
substitution. Using the text file from the previous examples, an 
inner boundary of lines that contain the words FOUR through SIX 
are set to substitute the word TEXT for LINE. A second boundary 
is specified as the lines that contain the words THREE through 
SEVEN, and a third boundary is specified as the lines that 
contain the words TWO through EIGHT. This example is impractical 
for a small file, but it will illustrate the full use of three 
boundaries and the =STRING command. 
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♦ sos/nonumbe;.r sample ♦ txtQ^ 
edit: samf>le»txt 

*P|ONEf QiD 

( Est ) C ^^'^ ) 

:|TEN| (JtT) 

( FSC } ( ^ fcSC ) 



LINE ONE 
LINE TWO 
LINE THREE 
LINE FOUR 
LINE FIVE 
LINE SIX 
LINE SEVEN 
LINE EIGHT 
LINE NINE 
LINE TEN 



tSC ) < ESt 



:xtI 



*SLINE*TEXTi*FOUR*/l QiD 

ES( ") ( ESC ) 



> ^ ESC ) ( ESC J 
\ i 

:*SIX|*THREEf/l QiL 



:*SEVEN|*TWOf/:LGiI 



ESC ; ( ES( 



Gp 



RET 
RET 
KEf 



TEXT FOUR 
TEXT FIVE 
TEXT SIX 
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Now you give the Print command to display the entire file, 
line contents specifications as the range. 

i \ 

#pioNE* CED 



using 



:li 



\ 



HEN* fiJIT) 

LINE ONE 
LINE TWO 
LINE THREE 
TEXT FOUR 
TEXT FIVE 
TEXT SIX 
LINE SEVEN 
LINE EIGHT 
LINE NINE 
LINE TEN 
* 



When you give the =STRING command, the entire Substitute command 
specifications are listed so that you can check the characters 
and the line contents used as boundaries, 

*=--string gid 
find: 



TEXT 
LINE 

i: 

SIX 

2: 

SEVEN 

3: 

EIGHT 



substitute: 

for: 

line-contents: 



8-8 



CHAPTER 9 
SOS FILE BACKUP 



It is recommended that, while you are creating or editing a file on 
your installation of the TOPS-10 monitor, you back up your file often 
enough to protect your inputs and edits. SOS file backup may be 
accomplished with the /ISAVE or /SAVE option or with the world command 
without ending your SOS session. It is good practice to back up your 
files every 15 minutes or so during an SOS session. In that way, you 
are sure of not losing more than 15 minutes' work if the system 
crashes. Though backing up your file may be time-consuming, it will 
prevent you from having to start all over again. 



9.1 THE WORLD (SAVE-THE-WORLD) COMMAND 

The World command saves your file, but lets you continue editing 
without ending the SOS session. The World command does not change 
your place in the file. It is good practice to give the World (or 
End) command before walking away from your terminal so that your work 
is saved. 

To give the World command, type a W at SOS command level and press 
RETURN. SOS prints the name of the file and leaves you at SOS command 
level . 

C nSKC : S AMF'LE . TXT i 27 r 5107 11 
* 

The World command creates a backup file with the file extension .Qxt 
and saves all edits to your file made since the last backup file was 
created. In the example above, SAMPLE.TXT was saved with the current 
edits and a SAMPLE. QXT file was created. SAMPLE. QXT consists of your 
input file without the current edits. 

If the /OLD option was set, a file extension of .Zxt would be created 
(instead of a .Qxt-extension file) if a .Zxt-extension file did not 
already exist. 
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9.2 THE AUTO-SAVE FEATURE 

The auto-save feature is initiated when you specify or set the /ISAVE 
or /SAVE options. If you are creating a new file, specify the 
/ISAVE:n option in the SOS command before or after the entire file 
specification. If you aire editing a file, specify the /SAVErn option 
in the SOS command before or after the entire file specification. 
Both options must be specified with a number (n) , from 1 to 99999, 
which sets the auto-save feature to occur after that number of SOS 
commands. The difference between /ISAVE and /SAVE is that /ISAVE is 
intended for the Input mode and /SAVE is intended for the Edit mode. 
The /ISAVE operates after n lines have been input whereas /SAVE 
operates after n SOS commands have been given that change the file 
contents. The /ISAVE or /SAVE option remains in effect for the 
duration of the SOS session or until you change it. 



9.2.1 File Backup While Inputting 

In the /ISAVE:n option, the "n" specifies that auto-save will be 
performed after "n" lines have been entered as text into your file. 
In the example below, you create a file SAMPLE.TXT, specifying the 
/ISAVE option with the number :3. 

♦S0S/ISAMfc:.:3 SAMPLE* TXT (^iT) 
INPUT J SAMPLE ♦TXT 
00100 LINE ONE C17T3 
00200 LINE TWOQir) 
00300 LINE THREE GiD 

ITDOING AUTO-SAVEy PLEASE WAIT^J 

CDSKc: SAMPLE ♦ TXT ::i 

00400 

After every third line is entered into the file, SOS performs an 
auto-save automatically and then continues with the next sequential 
line number to be entered. If you end the SOS session at line number 
400 with an EQ command, your file will be saved because it was backed 
up by the auto-save feature. 

If you issue a World command before your file is saved by the 
auto-save feature, the /ISAVE value is reset to zero and the count 
begins again to auto-save automatically after n lines. 



9.2.2 File Backup While Editing 

In the /SAVE:n option, the "n" specifies that auto-save will occur 
after "n" SOS commands have been issued. SOS commands not counted by 
this option are those commands that do not change the contents of the 
text within the file. In the example below, you edit the file 
SAMPLE.TXT, specifying the /SAVE option with the number :3. 
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♦ sos/savih::3 sample: ♦txt c^it) 

EinJt SAMPLE ♦TXT 

*xioo GiD 

00100 LINE ONE PAGE GNEQID 

*R200 C^^ 

00200 TEXT LINE TWGChD 

1 LINES (00200/1) DELETEti 

JICD300 GiD 

1 LINES (00300/1) DELETED 

C DOING AUTO-SA>v'E» PLEASE WAIT*. J 

CDSKC:SAMPL£»TXTt:27»'ol07JJ 



After every third SOS command that changes the contents of the file, 
an auto-save will automatically be performed and you will be returned 
to Edit mode (SOS command level) . 

If you issue a World command before your file is saved by one of the 
auto-save options, the /SAVE value is reset to begin its count from 
that save. 



9.3 SAVING YOUR FILE 

The End command will save your file and end SOS, The Go command will 
also save your file, end SOS, and execute the last COMPILE, EXECUTE, 
LOAD, or DEBUG command that was given at TOPS-10 command level prior 
to the SOS session. 

SOS creates a backup file with a file extension of .Qxt when your file 
is edited for the first time. The "xt" of the extension is the last 
two alphanumeric characters from the file extension of your input 
file. Thus, if your file was named FILNAM.ABC, your .Qxt file is 
named FILNAM.QBC. The .Qxt file is updated automatically each time 
you save your file. You can suppress the creation or update of this 
.Qxt file by setting the /NOBAK option or by using the B option of the 
End or Go command. 



9.3.1 Ending SOS Saving The Line Numbers 

Type E (or G) and press the RETURN key to end SOS and save the file 
with line numbers. SOS saves your file, prints the file 
specifications, and leaves you at TOPS-10 command level. 

*EQID 

CDSKC: STATS ♦DATC:27y 51073 J 



or 

*G QTT) 

[;DSKC:STATS.DATi:27r5107J3 

(The appropriate TOPS-10 command is executed next. 
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SOS automatically renames the original file to filnam.Qxt and 
retains the line numbers. In this example, besides the new STATS.DAT, 
the original STATS.DAT is now called STATS. QAT, thus providing a 
convenient way to check changes. The .Qxt file also retains its line 
numbers. You may delete the .Qxt file with the TOPS-10 command 
DELETE, but you should do so only after you are sure that you have 
made the proper changes to your file. You may use the /NOBAK option 
to suppress creating or updating the .Qxt file, for example, to save 
space. 



9.3.2 Ending SOS Without Saving The Line Numbers 

Give the ES (or GS) command to end SOS, remove the line numbers 
(unsequence the file) , and then save the file. SOS removes the line 
numbers, prints the file specification, and then leaves you at TOPS-10 
command level. Both the ES and GS commands create a backup file with 
the file extension .Qxt. (The .Qxt backup file retains the line 
numbers of the original file only if the original file contained the 
line numbers before the SOS session.) 

*ES (TtT) 

CDSKC:STATS»HATC27r51073 3 

The ES (or GS) command is useful when you are preparing a file that 
will be read by a program that does not recognize line numbers. 

If your directory contains many files and you must conserve space, end 
your SOS sessions with an ES or GS. The savings in disk space can be 
substantial, as shown in the following example. 

♦SOS COBOL ♦ CBL dlD 
edit: COBOL ♦CBL 
*ES 



CDSKC: COBOL ♦CBLi:27y 51073 J 

.DIRECT/ALLOCQiD 

COBOL QBL 15 <055> 12- J AN- 78 DSKC: C 27^51073 
COBOL CBL 10 <055> 12 -JAN -78 

TOTAL OF 25 BLOCKS IN 2 FILES ON DSKC: C27fS1073 



An allocated 15-block COBOL source program is edited by removing the 
line numbers. With the TOPS-10 command DIRECT (for Directory) and the 
/ALLOC switch (for allocated length) , you can display the two files in 
the directory. The original COBOL source program file allocated 15 
blocks in the directory; the unsequenced COBOL source program file 
allocated only 10 blocks. You save 5 blocks of storage in your 
directory. 
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Other Programs And Line Numbers 

Some programs may not operate properly 
if they attempt to read a file that 
contains line numbers. In such a case, 
stop the program, run SOS, and use the 
ES command to save the file without line 
numbers. 



9.3.3 Ending SOS With No Backup File 

Type EB (or GB) and press RETURN to end SOS, save your edited file, 
and automatically suppress the creation of any backup files. Even if 
the SOS option /OLD is in effect, the EB and GB commands prevent 
creation of the .Zxt file extension as well as the .Qxt file 
extension. (If the /NOBAK option is set, you do not need to specify 
the B option when you give the End or Go command, as the /NOBAK option 
suppresses the creation of any backup files.) 

In summary, the EB command saves your currently edited file, does not 
create or update a .Qxt file, and returns you to TOPS-10 command 
level. The GB command saves your currently edited file; does not 
create or update a .Qxt file; and executes the last COMPILE, EXECUTE, 
LOAD, or DEBUG command before returning you to the TOPS-10 command 
level . 

♦DIRECT CUD 

NUM FOR 3 <055> ?~Dt:C~77 USKCt L27r5i073 

NUM QOR 3 <055> 7-DEC-77 

TOTAL OF 6 BLOCKS IN 2 FILES ON DSKC: C27» 51073 

♦SOS /OLD NUM^FORCiD 
EIUT: NUh^FOR 

*ST IRE *TYPE I-" i * » N GuD 
t f 

*eb (HD 

tiDSKC : NUM ♦ FORt 27 y 51073 3 



♦DIRECT CEE) 



NUM 



FOR 



3 <055> 



12~JAN~7B 



DSKC : 



C27r51073 



TOTAL OF 3 BLOCKS IN 1 FILES ON DSKCt C27» 51073 



In the example above, you edited the file NUM. FOR, specifying the SOS 
option /OLD for the creation of a .Zxt file extension backup. By 
typing the EB command, you suppressed the creation of both the .Qxt 
file extension and the .Zxt file extension. 
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Depending on the file protection codes of the .Qxt files in your 
directory path, the EB, GB, or WB commands may also delete those .Qxt 
files as shown in the above example. The default protection code, 
<055>, allows you to delete the existing backup file when you give the 
EB, GB, or WB commands. 



9.3.4 Ending SOS Without Saving The File 

To end SOS without saving the changes you made to the file, type EQ 
(or GQ) and press the RETURN key. 

ti-Q CEeD 

♦ 

The EQ, GQ, or WQ command does not save any changes made to the file 
since you gave the last SOS command. If you created a file, it is now 
gone; if you edited a file, the changes are now lost. But if you 
have given a World command during the SOS session, only the changes 
made since your last World command are lost. Since SOS does not have 
to do any work, EQ, GQ, or WQ commands operate very quickly. 

An EQ, GQ, or WQ command is useful in the following circumstances: 

1. When you have used SOS to merely read through a file, there 
is no reason to resave it because you have not made any 
changes. 

2. After you have given a command or an edit that makes your 
file useless, you can give the EQ, GQ, or WQ command to 
cancel that part of the SOS session. 

3. If you want to try a particular SOS command, you can start 
SOS, give a World command, and try the particular command. 
Then, if the command does not work the desired way, give the 
EQ, GQ, or WQ command to restore the original file. 

End, Go, or World commands also have a delete capability. The ED, GD, 
or WD commands must be used with extreme caution. They delete both 
your edited file (output from SOS) AND your original file (input to 
SOS) unless your original file has a protection code greater than or 
equal to <400>. 



9.4 SOS BACKDP FILES 

Every time you change an existing file and then save it with an End, 
Go, or World command, SOS creates a backup file. The following 
examples show, by the creation and editing of a text file in SOS, how 
the backup files are managed. 



♦ SOS • 


rEXT^FIL C^iT) 




INF-'UT 


: TEXT. 


► FIL 




00100 


ONE 


HUNDREI.! 


1 ( RET ) 


00200 


t 







*E GK) 

CDSKBtTEXT^FILJ 
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After the creation of the file, there is only one image of the file 
TEXT.FIL in the directory path: [27,5107]. 



♦ DIRECT C^^ 

TEXT FIL 1 <055> 3~MAY-78 DSKBt i:27»5107J 
TOTAL OF 1 BLOCKS IN 1 FILES ON DSKB: 1:27^51073 



Now add a line to the file and save the changes. 

♦ SOS TEXT ♦ FIL C^TT) 
edit: text ♦FIL 

»i2Qor^ro 

00200 TWO HUNDFv'EDQiD 
00300 



*E CE^ 

CDSKB : TEXT ♦ FILC27 » 51073 J 

♦ 

The original file, TEXT.FIL, has been renamed to TEXT.QIL, and your 
current file (with two lines) is TEXT.FIL. 



♦DIRECT QiD 

TEXT OIL 1 <055> 3-MAY"-7B DSKB: L-27f51073 
TEXT FIL 1 <055> 3-MAY-78 

TOTAL OF 2 BLOCKS IN 2 FILES ON DSKBt i:27» 51073 



Add a third line to the file and save the changes. 

♦ SOS TEXT ♦FIL O^FT) 
edit: text ♦FIL 

*i300 GE) 

00300 THREE HUNDRED (^T) 
00400 I 

*E GE) 

CDSKB : TEXT ♦FILL"27f 51073 3 

♦ 

The original file, TEXT.QIL, consisting of one line of input has been 
deleted. The current .QIL file contains two lines of input and the 
TEXT.FIL file contains three lines of input. 

♦DIRECT CUD 

TEXT QIL 1 <055> 3-MAY-78 DSKB: i:27r 51073 
TEXT FIL 1 ::055> 3-MAY-78 

TOTAL OF 2 BLOCKS IN 2 FILES ON DSKB: L 27 r 51073 



If you do not want the .QIL files, you can set the /NOBAK option when 
you start the SOS session or during it. The /NOBAK option will not 
allow the current .QIL file to be updated when you save the TEXT.FIL 
file; it remains unchanged. 
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Now set the /NOBAK option when you edit the file 

♦ sos text^filqid 
edit: text,fil 



* /NOBAK QiT) 

00400 F-OUR HUNDRED CiJIT) 
00500 I 

GE3 



*EGiD 

LDSKB : TEXT ♦ F" ILL27 r 5107 J 3 

* 

The current updated file is TEXT.FIL (contains four text lines) , and 
the .QIL file still contains only two lines of text. The TEXT.FIL 
file that contained the three lines of text was deleted automatically. 

If you want to continually use this feature, add the /NOBAK option to 
your SWITCH.INI file. Whenever you run SOS, the /NOBAK option is then 
automatically given for you. 

NOTE 

If you do a lot of creating and editing 
of small files, backup files may become 
space- and time-consuming. If so, 
include the /NOBAK option in your 
SWITCH.INI file or issue the option when 
starting an SOS session. 



If you specify or set the /OLD option either when you originally 
created the TEXT.FIL file or at any time when you edit this file, a 
.ZIL file would be created. The ,ZIL file would contain the contents 
of your file as it appeared before any edits took place. 
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9.5 "INSUFFICIENT DISK SPACE - WELL?" MESSAGE 

If you exceed your disk block quota or available memory during an SOS 
session, SOS is unable to perform the last command given or to write 
your file to your specified directory path. It prints a message to 
that effect: 

and awaits a response. 

This section describes the possible responses you can employ, but 
there is no guarantee that they will work at all times; results are 
unpredictable. This is an unsupported feature of SOS. 

If the last command given was other than an End, Go, or World command, 
SOS prints: 

WELL? 

If the last command was an End, Go, or World command or possibly an 
auto-save, SOS prints: 

CINSUF-nCIENT DISK SPACE TO DO 0UTPUT3 

nnnn DISK DLOCKS IN YOUR AREA ON dev 

nnnnn BLOCKS FOR" ALL USERS ON THIS STRUCTURE 

WELL? 

Where: 

nnnn is the number of blocks in your disk area. This is the 
same response you would have gotten if you had given 
the =DISK command. 

dev is the structure to which output is being done. 

nnnnn is the total number of blocks to all users on that 
device structure. 

When you type an H to the WELL?, SOS will list the four acceptable 
responses that you can give. 

WELL? H 

YOU MUST type: 

G - DO THE OUTPUT (NOW AND FOREVER). 

T - TEST DISK SPACE AND DO OUTPUT IF SPACE AVAILABLE. 
R - GIVE RESOURCES AND DO OUTPUT IF SPACE AVAILABLE. 
W - WAIT UNTIL EITHER SPACE APPEARS OR YOU TYPE 
A DIFFERENT RESPONSE. 

WELL? 

Besides these four possible responses, you can press CTRL/C and type 
any of the five commands to the YES? response to either save your 
file, if possible, or return to the TOPS-10 monitor. 

If you use the CTRL/C and return to the TOPS-10 monitor, give the 
TOPS-10 command DIRECT to check your directory. There may be a 
nnnSOS.TMP file in your directory that will contain your file and all 
edits up to the point when you received the WELL? reply. (Refer to 
Chapter 10, for information on how to use this file.) 
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It is strongly recommended that you maintain enough free disk blocks 
in the specified directory so that this message will never appear 
during an SOS session. Back up your files on tape or another disk, or 
break up a large file into smaller parts for your SOS session to 
prevent the directory from becoming congested. 



9.5.1 Well? - G Response 

By typing a G to the WELL? question, you are attempting to force SOS 
to do the output. In most instances, nothing will happen and SOS will 
print the informational message: 

WELL? G 

8450 DISK BLOCKS IN YOUR AREA ON DSKC 

96800 BLOCKS FOR ALL USERS ON THIS STRUCTURE 

WELL? 

At this point you should try one of the other WELL? commands. 

If the G command works, the Edit mode prompt (*) will reappear or SOS 
will indicate that your file was backed up and the TOPS-10 prompt (.) 
will appear. 



9.5.2 Well? - T Response 

By typing a T to the WELL? question, you are attempting to test your 
disk for available space. In most instances, SOS will reply with the 
message DSK OK NOW. 

WELL? T 
DSK OK NOW* 

At this point, you may receive the SOS asterisk prompt indicating that 
your last SOS command has finished executing. If you receive the 
TOPS-10 period prompt, your edited file has been saved in the 
specified directory path. If neither the asterisk or period prompt 
appear, SOS will reply again with the following message: 

C INSUFFICIENT DISK SPACE TO DO OUTPUT J 

8450 DISK BLOCKS IN YOUR AREA ON DSKC 

96800 BLOCKS FOR ALL USERS ON THIS STRUCTURE 

At this time you should try another response to WELL?. 



9-10 



SOS FILE BACKUP 



9.5.3 Well? - R Response 

By typing an R to the WELL? question, you are attempting to print 
your disk resources, test your disk for available space, and, if 
possible, make the copy. If the R response works, the SOS asterisk 
prompt (or TOPS-10 period prompt) will appear on your terminal. 
Otherwise, the following message will appear: 

WELL? R 

8450 DISK BLOCKS IN YOUR AREA ON DSKC 

96800 BLOCKS FOR ALL USERS ON THIS STRUCTURE 

DSK OK NOW* 

n INSUFFICIENT DISK SPACE TO DO OUTPUT] 

8450 DISK BLOCKS IN YOUR AREA ON DSKC 

96800 BLOCKS FOR ALL USERS ON THIS STRUCTURE 

WELL? 

At this point you should try another response or press CTRL/C and 
respond to the YES?. (Refer to Chapter 2, Section 2.4.2 or Appendix A 
for the responses to the YES?.) 



9.5.4 Well? - W Response 

When you type a W to the WELL? question, SOS will wait until either 
space becomes available on disk or in memory or until you type a 
different response to the WELL? message. SOS will wait indefinitely, 
or until the system crashes, or until you type any other response. If 
you give another response while SOS is waiting, SOS will respond as if 
to an R response. 

A possible solution is to login to the TOPS-10 system from another 
terminal and backup and/or delete some files to obtain available 
space. As with all the WELL? responses, this may or may not work. 
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CHAPTER 10 
HOW SOS HANDLES FILES AND BOFFERS 



This chapter describes in detail the procedures SOS uses to protect 
your inputs and edits through its use of temporary buffer files and 
backup files. When you start an SOS session, SOS creates, in the 
directory path, a temporary buffer file that will be used 
automatically to create or update your output file when you give an 
End, Go, or World command. In addition, SOS may create an extra 
temporary buffer file when the current file exceeds the available 
memory for the SOS session. The amount of available memory allotted 
to an SOS session is 1280 words. This amount can be changed within 
the SOS source code; the SOS source must then be re-assembled for 
your installation. 



10.1 HOW SOS KEEPS THE CURRENT FILE IN MEMORY 

SOS uses, in addition to memory, two temporary files (called 
nnnSOS.TEM and nnnSOS.TMP) to keep track of your current edits. Thus, 
when you give an End, Go, or World command, SOS must first combine: 

1. The edits in memory 

2. The nnnSOS.TEM file 

3. The nnnSOS.TMP file 

before it can create the new version of the source file that will 
contain them. In the event that the system crashes while you are 
editing, you can obtain a major portion of your edits by properly 
combining one or more of the files. 

The next paragraphs contain a description of how SOS creates and uses 
these files and how you use them to recover from a system crash. 

Remember that either of the temporary buffer files described in this 
section occur before SOS creates a new image copy of the source file. 

Remember also that the source file (or the edits themselves) must 
exceed the memory words (1280 by default) for SOS to completely fill 
either or both of the two temporary buffer files. If the file you are 
editing does not exceed the allotted memory words, your source file 
and backup file are created as described in Section 10.2. 
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10.1.1 The Memory Buffer 

Whenever you edit your file, SOS brings your file into memory. SOS 
allocates a portion of memory, and, if your file is large, SOS places 
that part of your file that cannot fit in memory into the temporary 
buffer file named nnnSOS.TEM. As a result, if you attempt to edit a 
line that would cause the buffer to overflow, SOS transfers the 
current buffer file, nnnSOS.TEM, to another buffer file, nnnSOS.TMP. 

SOS never retrieves lines from the nnnSOS.TMP file; it only transfers 
lines to it. So, if you want to edit a line that is located before 
the first line in the current buffer (nnnSOS.TEM) , SOS must: 

1. write the rest of the source file to the nnnSOS.TEM file 

2. rename the nnnSOS.TEM file to be a nnnSOS.TMP file 

3. use the nnnSOS.TMP file for input 

4. create a new nnnSOS.TEM file 

The four operations listed above occur automatically; you cannot 
control them. You can, however, save SOS some trouble by localizing 
your edits. If you want to know the first line in the buffer, type 
the =LOCATION option command. (The total number of lines in the 
buffer at one time during an SOS session varies depending upon the 
amount of text contents per line.) 



10.1.2 The nnnSOS.TEM File 

The nnnSOS.TEM file is created automatically by SOS in a session 
containing any edits that SOS cannot fit in memory. This is a 
temporary buffer file residing in your specified directory path during 
an SOS session. The "nnn" is a three-digit number that consists of 
your TOPS-10 job number. Thus, the temporary buffer file for job 26 
on the TOPS-10 system may appear in the directory after a crash as: 

♦DIRECT GiD 

026S0S TEM 360 <055> 20-MAY~78 DSKC: L27f 51071 
TOTAL OF- 360 BLOCKS IN 1 FILES ON DSKC: 1127 ySlO?."! 



This is its complete name format. If it is empty, this file will not 
even appear in the directory because the system will delete it when 
restarting. The 026 refers to your job number at the time the crash 
occurred. You should always know your job number because there may be 
other nnnSOS.TEM files when other users are editing files in the same 
directory path. 

When you exit from the SOS session in the usual manner, this file 
becomes the new source file. 
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10.1.3 The nnnSOS.TMP Pile 

SOS creates an nnnSOS.TMP file as a temporary buffer file in your 
specified directory path when you re-edit a portion of the file during 
any one SOS session. The "nnn" is a three-digit number that consists 
of your current TOPS-10 job number. When this temporary file is 
created, it replaces your original input source file in the directory. 
After a crash, this temporary buffer file for job number 26 will 
appear in the directory path as: 



♦ DIRECT GID 

026S0S TMF' 360 <055> 20-MAY™7e DSKCt Z27y'51071 
TOTAL OF 360 BLOCKS IN 1 FILES ON DSKC: C27r5107:i 



This is its complete name format. If it is empty, this file will not 
replace your original source file and will not appear in the directory 
because the system will delete it when restarting. The 026 refers to 
your job number at the time the crash occurred. You should always 
know your job number as there may be other nnnSOS.TMP files when other 
users are editing files in the same directory path. 

When you exit from the SOS session in the usual manner, this file may 
become the new edited source file, if it is the most complete. 



10.1.4 Using The nnnSOS.TEM And nnnSOS.TMP Files 

Suppose you want to edit the file TEST. FOR. Give the command: 

♦ SOS TEST » FOR CUD 
edit: test ♦FOR 

SOS reads the contents of the source file and copies it to memory. 
SOS allocates a portion of memory in which to perform its functions, 
(The portion of memory allocated to your SOS session is usually a 
memory buffer.) When you edit a portion of the file, it must be 
brought into that memory buffer before you can make any changes. 
After you make the changes, SOS has five work areas. 

1. The current edits (kept in memory) 

2. The nnnSOS.TEM buffer file (in the directory) 

3. The nnnSOS.TMP buffer file (in the directory) 

4. The source file (TEST. FOR in the directory) 

5. The backup file (TEST.QOR in the directory) 
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The Symbol => 

In the diagrams that follow, the symbol 
=> indicates SOS's position in the 
particular buffer or file. 



SOURCE FILE 



=o 



• •• 


1 


• •• 


• •• 


2 


• •• 


• •• 


3 


• •• 


• •• 


4 


• •• 





MEMORY BUFFER 


=> 


••• 1 ••• 



The editing functions of inserting, deleting, and changing lines takes 
place automatically after the memory buffer is full. 
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The first time you access a part of your file beyond the capacity of 
the memory buffer, SOS places the contents of the memory buffer in the 
nnnSOS.TEM file, then refills the memory buffer. 



SOURCE FILE 



MEMORY BUFFER 



.TEM FILE 
(026SOS.TEM) 



=> 



»»# 


1 


#»# 


«« * 


2 


»•# 


» » * 


3 


# »• 


„• 


4 


#» • 




I « •« 



=> 
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In the same manner, if you access lines past the capacity of the 
second memory, SOS copies the contents of the second memory buffer to 
the nnnSOS.TEM file and then refills the memory buffer again. 



SOURCE FILE 



MEMORY BUFFER 



.TEM FILE 
(026SOS.TEM) 



=> 



*•• 


1 


• »» 


• «» 


2 


»•» 


• «• 


3 


« «« 


• •• 


4 


* »« 
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Now, if you want to edit a line that was located in the first memory 
buffer, SOS must do four things: 

1. Copy the rest of the source, file to the nnnSOS.TEM file. 



SOURCE FILE 



MEMORY BUFFER 



.TEM FILE 
(026SOS.TEM) 



=> 



# •# 


1 


• » • 


♦ »• 


2 


»•« 


«»« 


3 


* •* 


.., 


4 


*«* 




=> 



... 


1 


... 


• « * 


2 


... 


,.. 


3 


... 


... 


4 


... 



2. Close the source file (note that the source file has not been 
altered) . 
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3. Rename the nnnSOS.TEM file to be a nnnSOS.TMP file, then use 
it (instead of the source file) for input. 

4. Create a new nnnSOS.TEM file that is initially empty. 



.IMP FILE 
(026SOS.TMP) 



« •• 


1 


* *• 


•„ 


2 


• »• 


... 


3 


.„ 


» •» 


4 


... 





WEMORY BUFFER 


=> 


1 



.TEMFILE 
{026SOS.TEM) 




When you exit from an SOS session, the SOS program will look at both 
the nnnSOS.TMP file and the nnnSOS.TEM file and determine which file 
is the more complete and up-to-date. If the nnnSOS.TMP file exists 
but there were no edits to it since its creation, the SOS program will 
use the nnnSOS.TMP file to create the new source file. If edits have 
been performed after the creation of the nnnSOS.TMP file, the SOS 
program creates the new source file using the nnnSOS.TEM file, 
deleting the nnnSOS.TMP file and saving disk space. 
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10.2 WHAT HAPPENS TO YODR FILES AFTER AN E, G, OR W COMMAND? 

After an End, Go, or World command is given, SOS retains two copies of 
your file. They are: 

1. the edited copy of the source file 

2. the next most recent copy of the file (kept as the backup 
file) 

The edited copy of the source file becomes your output file from an 
SOS session. The file on disk that was the input to the SOS session 
becomes the backup file. Thus to review the whole process, if you 
give the command: 

♦SOS NUMBER ♦ TXT CmD 
edit: number* TXT 

SOS makes a copy of this file in memory for the SOS session. When you 
save this file, SOS automatically renames the file NUMBER.TXT in the 
specified directory path to become your backup file and the edited 
NUMBER.TXT file in memory to become your updated file. The backup 
file has the same file specifications as your source file, but has a Q 
as the first letter of the file extension. Thus, the backup file 
associated with NUMBER.TXT is NUMBER. QXT. If the /OLD option is in 
effect, a backup file with a file extension beginning with the letter 
Z is created if it does not already exist. 

At the end of your SOS session, you give the End (or Go) command to 
save the file and end the SOS session. The same file operations 
happen, in that SOS renames the old source file to be the backup file, 
and then stores the current edits or input in a new source file. In 
actuality, SOS creates a temporary buffer file in the specified 
directory path, containing your input and edited source file, and then 
renames this temporary file as your new source file. (Refer to 
Section 10.1 for a complete description of how the temporary buffer 
file(s) work during an SOS session.) 

Let's take the case where you are creating the file NUMBER.TXT. 
First, you give the SOS command, and then type a line. 

♦ SOS NUMBER* TXT CmD 
input: number ♦TXT 

00100 ONE OTT) 

00200 * 
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At this point, your file resides only in memory, not on your default 
directory path. SOS has created a temporary buffer file in the 
directory, but it is empty. 

CURRENT EDITS 




MEMORY 



To make a copy of the file in the directory, give the World command. 



CDSKC: NUMBER ♦TXT J 
* 

After you give the World command, SOS stores an image copy of the file 
input from memory into a temporary buffer file (invisible to you), 
renames this temporary buffer file to NUMBER.TXT, and then prints the 
name of the source file in the directory path on your terminal. This 
is the first permanent image of the source file. There is no backup 
file yet, but there is a duplicate copy of the file in memory and a 
new temporary buffer file is created for the next End, Go, or World 
command . 



CURRENT EDITS 



NUMBER.TXT 





MEMORY 



SOURCE FILE 



Now insert a second line and press ESCape 

*I200 CZlC 
00200 'WO GO 
00300 $ 

t 
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The input in memory contains two lines, but the source file on disk 
contains only one line. 



CURRENT EDITS 



NUMBER.TXT 





MEMORY 



SOURCE FILE 



When you now give the World command, SOS renames the source file on 
disk to be the backup file NUMBER. QXT, stores an image copy of the 
memory in the temporary buffer file, renames the temporary buffer file 
to NUMBER.TXT, and creates a new, empty, temporary buffer file. Last, 
SOS prints the name of the source file on your terminal. 

>KW ( RET ) 



i: nsKC T numbe:r ♦ rxi c 27 r '5 107 j j 
* 



The contents of the files are as follows: 

CURRENT EDITS NUMBER.TXT 





NUMBER. QXT 




MEMORY 



SOURCE FILE 



BACKUP FILE 



Now insert a third line and press ESCape 
*I300 QeD 



()0;50() THREE C^ 
00400 * 



10-11 



HOW SOS HANDLES FILES AND BUFFERS 



In this stage, the current edits contain three lines, the source file 
contains two lines, and the backup file contains one line. 



CURRENT EDITS 




NUMBER.TXT 




NUMBER.QXT 


ONE 
TWO 
THREE 




ONE 
TWO 




ONE 
TWO 














MEMORY 




SOURCE FILE 




BACKUP FILE 



Now give an End command to save the file and end the SOS session. The 
End command causes SOS to automatically delete your NUMBER.QXT backup 
file, rename the input source file (NUMBER.TXT) as the new backup file 
(NUMBER.QXT) , store the input from memory in the temporary buffer 
file, rename this temporary buffer file as your new source file 
(NUMBER.TXT), and print the name of your source file on your terminal. 
Your backup file now contains two lines of input. Your source file 
now contains three lines of input. 



* F. (RtL 



CDSKC : NUMBER . TXTL27 , 5107 J ;j 



CURRENT EDITS 



NUMBER.TXT 



ONE 
TWO 
THREE 



ONE 
TWO 
THREE 



NUMBER.QXT 




MEMORY 



SOURCE FILE 



BACKUP FILE 



Every time you give an End, Go, or World command the same process 
happens: 

1. The old backup file is deleted. 

2. The input source file becomes the new backup file. 

3. The temporary buffer file retrieves the inputs/edits from 
memory. 

4. The temporary buffer file is renamed as the new source file. 

5. The source file specification is printed on your terminal. 
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10.2.1 Turning Off The Backup System - /NOBAK Option 

If you do not want the backup files, set the /NOBAK option in your SOS 
command at TOPS-10 command level, at SOS command level, or in your 
SWITCH.INI file. Then whenever you give an End, Go, or World command, 
SOS will update only the source file; it will not create any backup 
file and if a backup file with a file extension of .Qxt already exists 
for the file you are editing, this file will be deleted automatically 
when you save your file if it has a protection code of less than 
<400>. 



10.2.2 Keeping A Permanent Backup File - /OLD Option 

Each time you give an End, Go, or World command, SOS creates a new 
backup file with the file extension of .Qxt. You may keep this file 
as a permanent backup file by setting the /OLD option. Whenever you 
give an End, Go, or World command, SOS does not create the usual 
backup file with the .Qxt file extension; instead it creates a file 
where the first letter of the extension is a Z. If, however, there is 
already a file with that file specification, SOS creates the normal 
.Qxt backup file (if not suppressed) and leaves the .Zxt file 
unchanged. Once a .Zxt file is created, SOS will not alter it. The 
only time SOS creates a .Zxt file is when one does not exist and the 
/OLD option has been set. 

For example, if you create a file TEST. FOR using the /OLD option, the 
first time you give an End, Go, or World command, SOS creates the 
source file TEST. FOR. After you give the second End, Go, or World 
command and before you create TEST.QOR, SOS checks to see if TEST.ZOR 
exists. Since it does not, SOS creates a TEST.ZOR file. The next 
time you issue an End, Go, or world command, SOS again checks to see 
if a TEST.ZOR file exists. Since this file does now exist, SOS does 
not create the .ZOR file, but does create the .QOR file. 

The /OLD option feature allows you to retain a copy of the file as it 
exists before a series of SOS sessions. When you are satisfied with 
the editing jobs, you can then delete the .Zxt file and let SOS create 
a new .Zxt file. 
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10.3 RECOVERING FROM A SYSTEM CRASH 

Suppose you are creating a new file without having set the /ISAVE or 
/SAVE options and you have not given a World command since the session 
began, and the TOPS-10 system crashes. You will have lost all of the 
input. When the TOPS-10 system restarts, you may have to reenter the 
entire file again. 

However, you may find a nnnSOS.TEM or a nnnSOS.TMP file in your 
specified directory path after the system restarts. (Only rarely will 
you find both buffer files in your directory at the same time.) With 
either buffer file, you may be able to reconstruct a recent copy of 
your file by following the steps outlined below. 

1. If neither buffer file exists, you will have to re-edit your 
source file again. You lost all edits back to the last 
backup. 

2. If the nnnSOS.TEM file survived the crash and it contains 
edited text of your file, it may be somewhat incomplete. At 
the TOPS-10 command level, rename this file so that SOS can 
use the name again as the buffer file when you start the SOS 
session to reconstruct your file. Using your original, 
unedited source file or backup file which was on disk and not 
lost by the system crash, and using the renamed buffer file, 
you can copy the missing lines needed to restore your file. 

3. If just the nnnSOS.TMP file survived, it is because you have 
done an internal wrap around of the edited file. This buffer 
file will be complete, except for any edits done after the 
internal wrap around occurred. The wrap around in this case 
occurred when you re-edited a previously edited portion of 
your file during the same SOS session. At TOPS-10 command 
level, rename this file so that SOS can create another 
nnnSOS.TMP file, if necessary, when you start the SOS session 
to reconstruct your file. To restore the file to the point 
when the system crashed, you must reenter edits that occurred 
after the internal wrap around. 

4. If the occasion occurs where the nnnSOS.TEM file and the 
nnnSOS.TMP file both exist in your specified directory path, 
the nnnSOS.TEM file may be incomplete. Thus, if both buffer 
files exist, rename each buffer file before starting the SOS 
session to reconstruct your file. Edit the renamed 
nnnSOS.TEM file, but this time copy the missing lines from 
the renamed nnnSOS.TMP file. 

The example on the next page assumes that you found after the system 
restart just the nnnSOS.TMP file. The example will show a very small 
amount of text, but, for the purpose of demonstration, it will assume 
that the file does exceed the allocated memory words for the SOS 
session. An nnnSOS.TEM file did exist before the system crash, but it 
was empty. When the system restarted, the nnnSOS.TEM file was 
deleted. 
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♦SOS SAMPLE* TXT GED 
edit: sample ♦TXT 

*p* c?ir) 

20000 THIS IS THE LAST LINE OF THE FILE 

*i» r^FQ 

20100 ONEQiD 

20200 TWO QID 

20300 THREE C^T) 

20400 FOUR QiF) 

20500 FIVE (JuJ 

20600 SIX C^ 

20700 * 
t 

*pio GID 

NO SUCH LINE<S) 

♦ IIOQ^FP) 

00010 THIS IS THE FIRST LINE OF TEXT. CUD 

* 

The PlO and the 110 commands above have caused the internal wrap 
around and the creation of the nnnSOS.TMP file. At this point the 
nnnSOS.TEM file has become empty. In addition, the nnnSOS.TMP file 
has replaced the original source file SAMPLE.TXT in the specified 
directory path. 

The system crashes, and when it is operational again, it prints a 
message. You log on and request a directory listing. The 026SOS.TMP 
is the only file that survived the crash. This temporary file 
replaced your SAMPLE.TXT file. 



TTY NOT CONNECTED 

RK3A4B KLIO SYS* 1026 15: 17: 03 

♦ LOGG^ 

JOB 26 RK3A4B KLIO SYS*1026 TTY233 

*27»5107GiD 

password: ct^d 



1306 22--MAY-78 WED 

♦ DIRECT G^D 

026S0S TMP 418 <055> 22-MAY-78 DSKC: 1:27^51073 
TOTAL OF 418 BLOCKS IN 1 FILES ON DSKC: 1127? 5107!] 



You now rename the temporary file 026SOS.TMP to be BUFFER.TXT, 



♦ RENAME BUFFER . TXT=-026S0S ♦ TMPGID 

FILES renamed: 

026S0S.TMP 
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Now you start SOS to edit the file BUFFER.TXT and give Print commands 
to check what previous edits were lost by the system crash. 

♦ SOS BUFF- E-;K% TXT CEID 
EDIT J buf-fe:r*txt 

♦P201 00 GiD 

20100 0N£ 

20100 ONE 

20200 TWO 

20300 THREE 

20400 FOUR 

20500 FH^E 

20600 SIX 

♦ FIOCED 

NO SUCH LINE<S) 
* 

You can now reenter line 00010 and end the SOS session to save your 
file. 



*I10 C^il 

00010 THIS LINE IS REF-'LACED BECAUSE OF THE CRASH, Qi?) 

♦ E CED 

C: DSKC : BUFFER ♦ TXTt 27^51 07 J "J 

At this point, you may continue to edit the BUFFER.TXT file as this 
file specification or rename it to SAMPLE.TXT. 



♦ RENAME SAMPLE . TXT==^BUFFER ♦ TXTGiD 

FILES renamed: 

BUFFER ♦TXT 



A few cautions about recovering files: 

1. Always check the contents of the nnnSOS.TEM file, the 
nnnSOS.TMP file, and the source and backup files very 
carefully before you restore and rename your edited source 
file. 

2. In the above example, the line numbers happened to be the 
same. If you have inserted lines or deleted lines, then the 
line numbers may not match. Be careful to use the correct 
line numbers. 
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APPENDIX A 
SUMMARY OF SOS COMMANDS 

Table A-1 



Symbol 


Meaning 


* 

* 


First (line or page) 
Current (line or page) 
Last (line or page) 



Command: DEL or RUBOUT 

Function: Deletes one character from the current line being edited 

Example: »R500 ( ret ) ^ 

00500 THIS IS A SELETE\ETELES\DELETE EXAMPLE ♦GID 

t 

Cj)EL ) C "t^L ) C m^L )( DtL ) ( HEL ) CIJ^ 



*?•■'♦ GeD 

00500 this is a delete example* 

% 



Command: 
Function 



Example: 



CTRL/C 

Stops SOS, You must type one of the following: 

C - to continue automatically 

E - to end edit and close file 

Q - to quit and delete temporary files 

M - to return to monitor now 

R - to reenter at the entry point of your file 

in SOS and terminate last SOS command 
H - to get printout of possible responses 



;t{ (cTRL/0 

YES? (TYPE H FOR HELP)? M QID 
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Command : CTRL/G 

Function: Cancels the SOS command before you execute it. 

Example: *SCOHMAND*INSTF<UCTION 



t 



f 

(cTRL(,) ' 



Command: CTRL/R 

Function: Prints the current line without the line number 

Example: »R 1 00 CTTT) 

00100 THIS IS A CTRL/R EXAMPLE. 



THIS IS A CTRL/R EXAMPLE. 



Command: CTRL/U 

Function: During Input mode, erases the current line, allowing you to 
retype its contents. 

Example: *R:l00 (jir) 

00100 THIS IS A CTRL/U EXAMPLE . ;:U 



THIS IS THE LINE. QHJ^ 

tf * C HET ) 

00100 THIS IS THE LINE. 



Command: LF or LINEFEED 

Function: Prints the next line in the file. 

Example: (Current position is line 400.) 

KUD 

00500 THIS IS A LINEFEED EXAMPLE FOR APPENDIX A. 

Command: ESCape or ALT 

Function: 1. Prints the previous line in Edit mode. 

Example: (Current position is line 200.) 

00100 THIS IS AN ESCAPE EXAMPLE. PRINTS PREVIOUS LINE. 
* 

Function: 2. Ends Input mode. 

Example: *I400y 10 GID 

00410 THIS IS AN ESCAPE EXAMPLE. ENDS INPUT MODE . | 
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Command: .position (Move) 

Function: Moves the pointer to a specified position, 

Example: ♦SOS SAMPLE . rXT QiT^ 
EDITt SAMPLE ♦TXT 

♦ * %/% ( RET } 
% F' * ( RET ) 

PAGE 10 



79000 
* 



LAST LINEr LAST PAGE* 



Command: 
Function: 

Example: 



/option: value 



(Set) 



Sets a specified settable option 
option takes one. 

♦SOS SAMPLE.TXT QED 
EDITt SAMPLE ♦TXT 
*/DPY C^D 
*/LOWERCIiD 
*=CASE GID 
tUSPLAY C64 LOWER 
* 



and its value if the 



Command: 
Function: 

Example: 



=option 



(Give) 



Prints the value of a printable option or, when used with 
the . (Move) command, prints the line/page number of the 
pointer position. 

♦ SOS SAMPLE* TXT QeT) 
edit: sample ♦TXT 

*^caseChD 
c 

% :■= ♦ QFT) 
00000/1 



Command: 
Function: 

Example: 



@f ilespec 



(Indirect) 



Executes one or more SOS commands that are the line 
contents of the command file "filespec". 



♦ TYPE S»CMli(j«!D 

00100 ST:[PE"LTYPE"^r:» 

. SOS SAMPLE ♦ TXT QeD 
edit: sample ♦TXT 
*P2020 r^JD 
02020 TIPE A NUMBER; ♦ 

*eS^CMDGlD 

02020 TYPE A NUMBEFv* 

%indif;;ect egp 
* 
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SUMMARY OF SOS COMMANDS 

Command: Arange 

Function: Starts Alter mode, which allows you to edit a line without 
retyping it. 

The following symbols are used in Alter mode instructions 
and examples: 

Indicates the position of the pointer. 

n Represents an integer number which, if 
omitted, defaults to 1. 

Indicates that the command may work both 
forward and backward. 

c Indicates where you may type a single 
character . 

chrs Indicates where you may type more than one 
character . 

Instruction: nCchrs 

Function: Change n characters. 

Example: »P C^^T) 

00100 THIS I A AN ALTER EXAMPLE* 

*A100GiD 

00100 THIS IS AN ALTER EXAMPLE* 

"t f 

W 2CISri^ 



Instruction: -nD 

Function: Delete the next/last n characters. 

Example: *P100 QiD 

00100 THIS IS AN ALTER EXAMPLE* 

*A100 Q^D 

00100 THIS WIS ANW ALTER EXAMPLE* 

t t 

W 5D CUD 



Instruction: E 

Function: Finish Alter mode for the current line without 
printing the rest of the line. 
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SUMMARY OF SOS COMMANDS 

Example: *P100 GnJ 

00100 THIS IS AN ALTER EXAHPLE. 

♦A* ( "^T ) 

00100 THIS IS 

t t 

2U E 



Instruction: nlchrsC^D 

Function: Insert characters into the current line. 
<ESC> ends the insertion; <LF> creates a new 
line using n as an increment. 

Example: #P100 GID 

00100 THIS ALTER EXAMPLE* 

♦AlOOQiD 

00100 THIS IS AN ALTER EXAMPLE* 



t t 

w iisCEDANC^DGiDQiD 



Instruction: J 

Function: Place the rest of the current line at the 
beginning of the next line. 



Example: *P100;200GiD 

00100 THIS IS AN ALTER EXAMPLE* 
00200 

*A» ( RET } 

00100 THIS IS AN 

t "t 

3W J 

00200 ALTER EXAMPLE* 

t 



Instruction: -nKc 

Function: Delete to the nth next/previous occurrence of 
c. 

Example: *P100 

00100 THIS IS AN ALTER EXAMPLE* 

* A* C "ET ) 

00100 \ NTH IS IS AN WALTER EXAMPLE* 

t t 

2KA GID 

*P. C^T) 
00100 ALTER EXAMPLE* 
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Instruction: L 
Function: 



Example : 



Print the rest of the current line and return 
to the beginning of the current line. 

tPlOO CI^tJ 

00100 THIS IS AN ALTER EXAMPLE* 

*A ♦ ( KET ) 

00100 THIS IS AN ALTER EXAMPLE* 

t t 

W L 



00100 



Instruction: P 

Function: Print the rest of the current line and the 
beginning of the current line to the current 
position. 

Example: )f:P100 ( «tT ) 

00100 THIS IS AN ALTER EXAMPLE* 

*A* QiD 

00100 THIS IS AN ALTER EXAMPLE* 

t t 

W P 
00100 THIS 

t 



Instruction: Q 
Function: 



Example : 



Quit Alter mode and restore the original line 
contents. 

*P100 ( "T ) 

00100 THIS IS AN ALTER EXAMPLE. 

♦A* QiD 

00100 WTHISWTHE WIS AN W 

! t t 

XTHECmD 2KA Q 

*p. GED 

00100 THIS IS AN ALTER EXAMPLE* 
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Instruction: -nRchrs 

Function: Delete the next/last n characters and then 
enter characters to the line. 

Example: *P100 QeT) 

00100 THIS IS AN ALTER EXAMF'LE* 

*A» C RET ) 

00100 WTHIS IS ANWTHE ALTER EXAMPLE* 





t t 

lORTHECtstJ) C^eT^ 

*P ♦ ( KET ) 

00100 THE ALTER EXAMPLE. 


Instruction: 


-nSc 


Function: 


Search for the nth next/pre\ 



character c. 

Example: «P100 QeT) 

00100 THIS IS AN ALTER EXAMPLE. 

*A. ( RET ) 

00100 THIS IS AN ALTER EXAMPLEX .ELPMAXE 

t t t f 

SA S. -2SE E 



Instruction: nW 

Function: Skip forward n words. 

Example: *P100 QeT) 

00100 THIS IS AN ALTER EXAMPLE. 
*A. QiT) 

00100 THIS IS AN ALTER EXAMPLE. 



t t t t t t 

w WWW w wGhD 



Instruction: Xchrs ( esc ) 

Function: Delete the current word and then enter 
characters to the line. 

Example: »P100 C^JFT ) 

00100 THIS IS AN ALTER EXAMPLE. 

*A. QiD 

00100 THIS IS AN WALTER WSOS EXAMPLE. 

f t f 

2SA xsosCEDCI^CEeD 

*P. ( RET ) 

00100 THIS IS AN SOS EXAMPLE. 
* 
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SUMMARY OF SOS COMMANDS 

Instruction: -n ( sp ) 

Function: Space (skip) forward n characters. 

Example: »P1 00 CTTT) 

00100 THIS IS AN ALTER EXAMPLE. 

#A* C RtT ) 

00100 THIS IS AN ALTER EXAMPLE, 
t t t 

7CsD 9CZD CIE) 



Instruction: n C "tQ or n ( ^cbou^ 

Function: Backspace n characters, but with no deletion. 

Example: *P 1 00 QiD 

00100 THIS IS AN ALTER EXAMPLE. 

*A» C RET ') 

00100 THIS IS AN ALTER \ RETLA\ALTER EXAMPLE. 
t t t t t t 

w WWW 6C»tD GID 

*P. ( RU ) 

00100 THIS IS AN ALTER EXAMPLE. 



Instruction: Qrr) 

Function: Print the rest of the line and return to SOS 
command level. 

Example: HcPiOO ( "ti ) ^ 

00100 THIS IS AN ALTER EXAMPLE* 

*.A» CEED 

00100 THIS IS AN ALTER EXAMPLE. 



t 



Instruction: - C tab ) 

Function: Skip to th^ end/start of the current line. 

Example: *P100 GiD 

00100 THIS IS AN ALTER EXAMPLE. 

*A. ( ^f ) 

00100 THIS IS AN ALTER EXAMPLE* 

t t 

( TAB ) - ( TAB ) 

\»ELPMAXE RETLA NA SI SIHT\ 
00100 

t 

E 
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Instruction: (ctklmj) 

Function: Restore the original line and remain at Alter 
command level. 

Example: *F'100 CEtT) 

00100 THIS IS AN ALTER EXAHPLE* 

*A» ( wq ) 

00100 WTHIS IS ANWTHE 



t 



t 



iortheG«3 <^i^ 

00100 this is an alter exahple. 

t 

CID 



Command: Cposit ion, range, f irst-page-inc,last-page-inc 

Function: Copies a range of .lines so that the first line being copied 
starts at or immediately after the position specified, 

first-page-inc, last-page- inc 

Specify the line-number increment for the first 
page and/or the last page being copied. 

Example: ^SOS SAMPLE ♦TXT CUD 
edit: sample ♦TXT 

*P800 C^ 

00800 THIS IS A COPY EXAMPLE ♦ 

*C200»800 GiD 

INC1==00020 

00220 THIS IS A COPY EXAMPLE* 
* 



Command: Cposition=filespec, range 

Function: Copies the range from the filespec named to the specified 
position in your file. 

Example: ♦TYPE NUMBER ♦ TXT QE) 
00100 ONE 
00200 TWO 
00300 THREE 
♦ SOS SAMPLE ♦ TXT CED 
EfilTI SAMPLE.TXT 

* C: 1 000-=-"NUMBER ♦ TXT y 1 00 : 300 QID 
INCl-^00020 

*P1020!3 GID 
01020 ONE 
01040 TWO 
01060 THREE 
* 
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Command: Cposition=f ilespec/S 

Function: Lets you search the filespec named, then specify the range 
to copy to the position in your file. SOS prompts with 
C* . You give Find and Print commands, then type E to give 
the range, or EQ to abort. 

Example: . SOS SAMPLE ♦TXT ChD 

edit: sa«f*le«txt 
*c1000=number.txt/s c«d 

C*P100:300 OiTQ 
00100 ONE 
00200 TWO 
00300 THREE 

SOURCE LINES- 100 : ;300 GiD 

INC 1=00020 

* 



Command: Orange 

Function: Deletes a range of line(s). 

Example: ♦SOS SAMPLE ♦ TXT Q^ 

edit: sample.TXT 

#D900:i200C«iD 

4 LINES (00900/1 :01200) DELETED 



Command: Eoption: filespec 

Function: Ends the SOS session, saves the file, and returns you to 
TOPS-10 command level. 



option 



: filespec 



B Suppresses the .Qxt and .Zxt file creation. 

D Deletes both the input and output file. 

Q Ends SOS and restore the original file. 

S Removes the line numbers from the file. 

Output file specification 



Example: » SOS SAMPLE ♦ TXT CriD 

edit: sample.TXT 
*Es GiD 

CDSKC: SAMPLE. TXTC27r5107D J 
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Command: Fstring<ESC> range, opt ion, number 

Function: Prints the first line located in the range that contains 
the string of characters. 



range 



Specifies the range of line/page numbers 
searched by the Find command. 



option 



number 



A Enters Alter mode for each line where the 

string is found. 
N Prints only the line number where the 

string is found. 
E Requires an exact match of 

uppercase/lowercase characters. 

Specifies the number of lines searched by the 
Find command. 



Example: »SOS SAMPLE.TXT GiD 
edit: sample ♦TXT 
*FTHIS IS °A FIND EXAMPLE $^ t » CTiF 

( LSC ) 

12505 THIS IS A FIND EXAMPLE* 



Command: Goption: f ilespec 

Function: Saves the file, ends SOS, and either executes the last 
Compile-class command or executes a program as specified by 
the /RUN option. 



Example: 



option 



: f ilespec 



.SOS SAMPLE* TXT L^ 
EDIT J SAMPLE ♦TXT 
*GS : NUMBER ♦ FOR QID 



Does an EB command and then a Go, 

Does an ED command and then a Go, 

Does an EQ command and then a Go. 

Does an ES command and then a Go, 



Output file specification 



cdskc: number ♦for 3 

link: loading 

clnkxct number execution] 

please type a number* 

lOOQlD 

YOU TYPED THE NUMBER 100*0000000 

TWICE 100^0000000 IS 200 ♦ 0000000 

END OF EXECUTION 

CPU time: 0*14 ELAPSED TIME: 7*00 

EXIT 
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Command : 
Function: 

Example: 



H 

Prints a text file showing a summary o£ SOS commands, 
options, and hints, with one-line descriptions^ of each 
command and option. 



♦ SOS SAMPLE >TXTc ret 

edit: sample.txt 

( SOS F-rints five pa^es of text* ) 



Command; 



Iposition, increment 



Function: Inserts new lines at the specified position which can be at 
the beginning or ending of the file, or between existing 
lines. 



Example: 



increment 



Specifies a line-number increment for insertion 
of lines following the position being inserted. 



♦SOS SAMPLE ♦ TXT GiD 

edit; sample.txt 

* 1 100 J 10 Q^ 

00110 THIS IS AN INSERT EXAMPLE. CIJT) 
00120^ ♦ 
t 



Command: Jposition 

Function: Appends the next line in the file to 
position, thereby joining the two. 

Example: » SOS SAMPLE . TXT GID 
edit: SAMPLE.TXT 

♦P100I2 GID 

OOlOO JOIN THIS 
00200 LINE. 

* Jioo GID 
*pioo GiD 

00100 JOIN THIS LINE. 



the specified line 
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Command: Jcrange 

Function: The Justification command is an optional SOS command and 
must be assembled for your installation of SOS. It 
justifies, according to c, all text within the range 
specified. 

One of the following must be the value of c when you issue 
the J command: 

C Justifies each line in the center between 
the left and right margins, 

L Justifies each line to the left margin. 

R Justifies each line to the right margin, 

U Justifies and fills each line to span from 
the left margin to the right margin, 

W Justifies to the left margin and fills with 
words to the right margin. 

Example: tSOS SAMPLE* TXT QtD 
edit: sample ♦TXT 

00100 LINE ONE* 
00200 LINE TWO* 
00300 LINE THREE* 

»jw 100:300 GE) 
*p 1 00 GiD 

00100 LINE ONE. LINE TWO* LINE THREE* 

Command: K/page-number 

Function: Deletes the page mark within the file as specified by 
/page-number. 

Example: *SfJS SAMPLE ♦ TXT QiD 
edit: SAMPLE .TXT 

*p/i:/2 GlD 

PAGE 1 

00100 THIS IS PAGE ONE* 

PAGE 2 

00200 THIS IS PAGE TWO* 

«K/2 CID 

*p/i GiD 

00100 THIS IS PAGE ONE* 
0^0200 THIS IS PAGE TWO* 
* 
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Command: Lrange,S 

Function: Lists a specified range of lines on the line printer. If 
range is not specified, the entire file is printed. The 
,S, if used, suppresses the printing of the line numbers 
and page headings. 

Example: » SOS SAMPLE ♦ TXT CED 
edit: sample ♦TXT 

#L/irS Gil) 
* 



Command: Mposition 

Function: Marks the specified position as the beginning of a 
page. 

Example: ♦SOS SAMPLE ♦ TXT OTQ 
edit: SAhPLE.TXT 

00100 THIS IS PAGE ONE* 
00200 THIS IS PAGE TWO* 
*M200 QED 
*P/2 CrTT) 
PAGE 2 

00200 THIS IS PAGE TWO* 



new 



Command: Nop t ion, increment, range , starting-number 

Function: Renumbers the line numbers in the range by a specified 
increment. If the increment is not specified, the default 
is 100. 



option 

increment 

range 

start 



A Adds increment to line numbers in the 

range. 
P Preserves line numbers in one sequence for 

the whole file over page marks. 

Any integer from 1 to 99999. 

The range of line numbers to be renumbered. 

The starting number for the first line. 



Example: ♦SOS SAMPLE ♦ TXT CIliD 
EDIT^ SAMPLE ♦TXT 

* p C?iO 

00100 LINE ONE* 
00200 LINE TWO. 
00300 LINE THREE* 
* N 1 ^> y / 1 y 1 'O CIlD 

*■ f' '" ♦ * CUT) 

00015 LINE ONE, 
00030 LINE TWO* 
00045 LINE THREE. 
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Command: Prange,S 

Function: Prints the contents of a specified range. If the range is 
omitted, the /PLINES option value (default is 16) is used 
for the number of lines to be printed. The ,S, if used, 
suppresses the printing of "the line numbers. 

Example: ♦SOS SAMPLE. TXT QiD 
EPITJ SAMPLE.TXT 

*p f s CED 

LINE ONE. 
LINE TWO. 
LINE THREE. 
* 



Command: Rrange, increment 

Function: Replaces the contents of a specified range of line 
number (s) . 



increment 



Specifies a line-number increment for insertion 
of lines following the range being replaced. 



Example: .SOS SAMPLE. TXTQ^D 

edit; bample.TXT 

*R100? 10 diD 

00100 this is a r example. CED 

00110 * 

t 

1 LINES (00100/1) deleted 

* 



Command: Sstring<ESC>new-string<ESC> range, opt ion, number 

Function: Substitutes a specified string of characters with a 
new-string of characters throughout a specified range of 
lines. 



option 



number 



D Lets you decide on each substitution. 

N Suppresses all printing of the 

substitutions. 
E Requires an exact match of 

uppercase/lowercase characters. 

Specifies the maximum number of lines to perform 
the substitutions. 



Example: .SOS SAMPLE. TXT QiD 

edit: sample.TXT 

*SLINE*TEXTf'%*)K CED 

C ESC ) QsT) 

00100 TEXT ONE. 

00200 TEXT TWO. 

00300 TEXT THREE. 
* 
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Command: Tdestinat ion, source-range, first-page-inc,last-page-inc 

Function: Transfers the source-range of lines to or after a specified 
destination and deletes the source-range from the file. 

first-page-inc, last-page- inc 

Specify the line-number increment for the first 
page and the last page being transferred. 

Example: » SOS SAHPLE.TXT C«D 

edit: sample ♦TXT 

*P GiD 

00100 LINE ONE. 
00200 LINE TWO. 
00300 LINE THREE. 

*T400f 100 Gi\D 

INC1=00100 

#p«:»(irr) 

00200 LINE TWO. 
00300 LINE THREE. 
00400 LINE ONE. 



Command: Vcrange 

Function: The Inversion command is an optional SOS command and must 
be assembled for your installation of SOS. 

Inverts, according to c, all text within the range 
specified. 

One of the following must be the value of c when you issue 
a V command: 



Inverts all 
lowercase. 

Inverts all 
uppercase. 



uppercase 
lowercase 



characters 
characters 



to 



to 



Inverts all uppercase characters to 
lowercase and all lowercase to uppercase 
simultaneously. 



Example: .SOS SAMPLE. TXTCftD 

edit; sample. Txi 
♦P1200 QE) 

01200 this line is all lowercase. 

♦ WU1200C»D 
*P* €»»> 

01200 THIS LINE IS ALL LOWERCASE. 
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Command : 
Function: 



Example: 



Woption:f ilespec 

Backs up your file and returns to SOS command level 
(Save-the-World Command) . 



option 



: f ilespec 



B Does an EB command without ending SOS. 

D Does an ED command without ending SOS. 

Q Does an EQ command without ending SOS. 

S Does an ES command without ending SOS. 



Output file specification 



SOS SAMPLE* TXTGE) 
edit: sample ♦TXT 

♦ 1250 

00250 THIS IS A W EXAMPLE .QE) 

«uCIiD 

CDSKC: SAMPLE ♦TXTC27y 510733 



Command: Xrange,S 

Function: Allows you to extend a specified range of line(s) by 
inserting text at the end of each line. 
'S 

Suppresses the printing of the line contents that 
will be extended. 

Example: .SOS SAMPLE* TXT QiD 
edit: sample ♦TXT 

♦piooGID 

00100 LINE ONE 

♦X^^SQiD 

00100 - PAGE ONEROID 

*P* ( KET ) 

00100 LINE ONE ~ PAGE ONE^ 
* 
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APPENDIX B 
SUMMARY OF SOS OPTIONS 



Table B-1 lists each SOS option and, if appropriate, the command 
necessary to set the option and print its value. Each name can be 
abbreviated to the letters that distinguish it from any other option 
name. For instance, you must use /NODEL to uniquely identify 
/NODELETE while only /CI is required for /C128. 



B-1 
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Table B-1 
Summary of SOS Options 



Name 


Set 


Print 


Default 


Function 


. (Period) 




^ • 


None 


Print current position 
in your file. 


BAK 


/BAK 


=BAK 


On 


Create backup file 
(Qxt) with End, Go, or 
World command - reverse 
with NOBAK. 


BASIC 


/BASIC 




Off 


Set to edit a program 
created by BASIC. 


BIG 




=BIG 


None 


Print largest page 
number in your file. 


C64 


/C64 


=CASE 


On 


Declare 64-character 
set " reverse with 
C128. 


C128 


/C128 


=CASE 


Off 


Declare 128-character 
set - reverse with C64. 


CASE 




=CASE 


None 


Print state of C128, 
C64, DPY, M33, M37, 
LOWER, UPPER, 
SEPARATORS , 
NONSEPARATORS . 


DECIDE 


/DECIDE 


=DECIDE 


Off 


Use Decide mode in 
Substitute commands - 
reverse with NODECIDE. 


DELETE 


/DELETE 


=DELETE 


Off 


Delete both input and 
output files with End, 
Go, or World command 
reverse with NODELETE. 


DISK 




=DISK 


None 


Print current disk 
quota. 


DPY 


/DPY 


=CASE 


Off 


Set VT05 terminal 
characteristics. 


ERROR 




=ERROR 


None 


Print full text of last 
error message. 


EXPERT 


/EXPERT 




Off 


Set the Expert mode 
reverse with /NOVICE. 


INCREMENT 


/INC:n 


= INC 


100 


Set line number 
increment to n. 


I SAVE 


/ISAVE:n 


= I SAVE 





Give Auto-Save after n 
inserts. 
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Table B-1 (Cont.) 
Summary o£ SOS Options 



Name 


Set 


Print 


Default 


Function 


LENGTH 


/LENGTH ! n 


"LENGTH 


55 


Set length of printed 
page output to n. 


LMAR 


/LMAR:n 


=LMAR 


1 


Set left margin of 
printed output to n. 


LOCATION 




=LOC 


None 


Print location of first 
line in SOS buffer. 


LOWER 


/LOWER 


"CASE 


Off 


Set for lowercase 
character input 
reverse with /UPPER. 


M33 


/M33 


=CASE 


On 


Set normal 
characteristics for 
uppercase-only 
terminals. 


M37 


/M37 


"CASE 


Off 


Set terminal for both 
uppercase and lowercase 
input. 


MAXLN 


/MAXLN : n 


"MAXLN 


99999 


Set maximum number of 
lines per page to n. 


NAME 


/NAME 


"NAME 


Input 


Set name of output file 
specification. 


NOBAK 


/NOBAK 


"BAK 


Off 


Do not create backup 
file on End, Go, or 
World command - reverse 
with BAK. 


NODECIDE 


/NODEC 


"DECIDE 


On 


Do not use Decide mode 
in Substitute commands 
- reverse with DECIDE. 


NODELETE 


/NODELETE 


"DELETE 


On 


Do not delete 
input/output files 
reverse with DELETE. 


NONSEPARATOR 


/NONSEP 


"CASE 


On 


Consider %, &, and . as 
alphanumerics - reverse 
with SEPARATORS. 


NONUMBER 


/NONUMBER 




Off 


Suppress printing of 
line numbers - reverse 
with NUMBER. 


NOVICE 


/NOVICE 




On 


Set normal operation - 
reverse with EXPERT. 


NUMBER 


/NUMBER 




On 


Set line numbers to 
print - reverse with 
NONUMBER. 
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Table B-1 (Cont.) 
Summary o£ SOS Options 



Name 


Set 


Print 


Default 


Function 


OLD 


/OLD 




Off 


Create .Zxt backup file 
on End, Go, or World 
commands. 


OPTION 


/OPTION: name 


None 


Set the options in your 
SWITCH.INI file 
identified by name. 


PLINES 


/PLINES :n 


=PLINES 


16 


Set n lines to be 
printed by the Print 
command . 


PMAR 


/PMAR:n 


=PMAR 


1 


Set the first position 
of the paragraph margin 
for printed output. 


READONLY 


/READONLY 




Off 


Declare file can only 
be read; no editing 
can be done. 


RMAR 


/RMARrn 


=RMAR 


69 


Set right margin of 
printed output to n. 


RUN 


/RUN: file 


=RUN 


SY&:COMPIL 


Declare program to be 
run after a Go command. 


SAVE 


/SAVE : n 


=SAVE 





Give Auto-Save after n 
SOS edit commands. 


SEPARATORS 


/SEP 


=CASE 


Off 


Consider %, &, and . as 
non-alphanumerics 
reverse with 
NONSEPARATORS . 


SEQUENCE 


/SEQ 


=SEQ 


On 


Include line numbers in 
output file with End, 
Go, or World command 
reverse with 
UNSEQUENCE. 


START 


/START :n 


=START 


100 


Set starting line 
number to n. 


STEP 


/STEP:n 


=STEP 


100 


Set start and increment 
of line numbers to n. 


STRING 




=STRING 


None 


Print last string used 
in Find and Substitute 
commands or in line 
contents specification. 
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Table B-1 (Cont.) 
Summary of SOS Options 



Name 


Set 


Print 


Default 


Function 


UNSEQUENCE 


/UNSEQ 


=SEQ 


Off 


Remove line numbers 
from output file with 
End, Go, or World 
command - reverse with 
SEQUENCE. 


UPPER 


/UPPER 


=CASE 


On 


Declare uppercase 
character input 
reverse with LOWER. 



NOTE 

The LENGTH, LMAR, MAXLN, PMAR, and RMAR 
Options will be effective only when the 
Justification command has been assembled 
for your installation of SOS. 
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APPENDIX C 
SOS CHARACTER TABLE 

Table C-1 describes each character recognized by SOS. Each character 
has: 

1. An ANSI name 

2. An ASCII octal code 
Some characters also have: 

3. A control character representation 

4. A C128 representation 

For example, SOH (Start of Heading) has: 

1. An ASCII octal code of 001 

2. A control character representation of "A 

3. A C128 representation of '! 

The 64-character set is composed of the characters 040 (space) through 
137 (underline); the C128-character set is composed of all the 
characters in Table C-1. 

Table C-2 describes the ANSI character names for the (b) lines from 
the 00 line through the 03 line in Table C-1. 
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Table C-1 
SOS Character Set 








1 


2 


3 


4 


5 


6 


7 






— 


— 


— 


— 


— 


— 


- 


— 






"§ 


"A 


"B 


"C 


"D 


"^E 


"F 


~G 


(a) 


00 


NUL 


SOH 


STX 


ETX 


EOT 


ENQ 


ACK 


BEL 


(b) 






M 


1 II 


'# 


'$ 


'% 


'& 


•\ 


(c) 




"H 


"I 


"J 


"K 


'^L 


''M 


"N 


"0 


(a) 


01 


BS 
'( 


HT 


LF 


VT 


FF 


CR 


SO 


SI 
1 * 


(b) 
(c) 




'^P 


'*Q 


"R 


''S 


"T 


"U 


-V 


"w 


(a) 


02 


DLE 


DCl 


DC 2 


DC3 


DC4 


NAK 


SYN 


ETB 


(b) 




• + 


t 


1 _ 


1 

• 


V 


•0 


'1 


•2 


(c) 




'*X 


"Y 


"Z 


"[ 


'^\ 


"1 


A A 


/» 


(a) 


03 


CAN 


EM 


SUB 


ESC 


FS 


GS 


RS 


US 


(b) 




'9 


'6 


•4 


1 — 


•< 


•> 


'7 


'8 


(c) 


04 


Space 


I 


n 


« 


$ 


% 


& 


1 1 


(b) 
(c) 


05 


( 


) 


* 


+ 


1 


- 


m 


/ 


(b) 


06 





1 


2 


3 


4 


5 


6 


7 


(b) 


07 


8 


9 


: 


1 


< 


= 


> 


? 


(b) 


10 


@ 


A 


B 


C 


D 


E 


F 


G 


(b) 


11 


H 


I 


J 


K 


L 


M 


N 





(b) 


12 


P 


Q 


R 


S 


T 


U 


V 


W 


(b) 


13 


X 


Y 


Z 


[ 


\ 


] 


^ 




(b) 


14 




a 


b 


c 


d 


e 


f 


g 


(b) 
(c) 


15 


h 


i 


J 


k 


1 


m 


n 


o 


(b) 


16 


P 


q 


r 


s 


t 


u 


V 


w 


(b) 


17 


X 


y 


z 


{ 


1 


} 


~ 


DEL 


(b) 










•[ 


' : 


'] 


'3 


1 1 


(c) 


>» 





















(a) - Control-character representation 

(b) - ANSI Character name - see Table C-2 

(c) - C128 representation 
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Table C-2 
ANSI Character Names 



ANSI 




ANSI 




Name 


Description 


Name 


Description 


ACK 


Acknowledge 


ETX 


End of Text 


BEL 


Bell 


FF 


Formfeed 


BS 


Backspace 


FS 


File Separator 


CAN 


Cancel 


GS 


Group Separator 


CR 


Carriage Return 


HT 


Horizontal Tab 


DCl 


Device Control 1 


LF 


Line Feed 


DC 2 


Device Control 2 


NAK 


Negative Acknowledge 


DC 3 


Device Control 3 


NUL 


Null 


DC4 


Device Control 4 


RS 


Record Separator 


DEL 


Delete 


SI 


Shift In 


DLE 


Data Link Escape 


SO 


Shift Out 


EM 


End of Medium 


SOH 


Start of Heading 


ENQ 


Enquiry 


STX 


Start of Text 


EOT 


End of Transmission 


SUB 


Substitute 


ESC 


Escape 


SYN 


Synchronous Idle 


ETB 


End of Transmission Block 


US 


Unit Separator 






VT 


Vertical Tab 
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/APPENDIX D 
TOPS~10 STANDARD FILE EXTENSIONS 



Table Dvl lists the file extensions that have a specific meaning to 
the TOPS-10 system. When you create a file for use with a particular 
program, youi shoulcl assign the correct file extension. If you do, the 
TOPS-10 systhem has more information about the file and can attempt to 
perform the correct function after you type a minimum set of commands 
or switches. Normally, no penalty arises from assigning an undefined 
file extension, but if you assign an incorrect file extension, the 
TOPS-10 system may iincorrectly interpret the file, especially when you 
use the CONPILE-class commands. 



Table D-1 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 


AlO 


ASCII 


ASCII version of a TOPS-10 
program loaded by the PDP-11 


All 


ASCII 


ASCII version of a PDP-11 
program loaded by the PDP-11 


ABS 


Binary 


Absolute (nonrelocatable) 
object program 


AID 


ASCII 


Source file in AID language 


ALG 


ASCII 


Source file in ALGOL 
language 


ALP 


ASCII 


Printer forms alignment 


ATR 


Binary 


Attribute file in SIMULA 
language 


AWT 


Binary 


Data for automatic wire 
tester 


BIO 


ASCII 


Source file in BLISS 


Bll 


ASCII 


Source file in BLISS-11 
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TOPS-10 STANDARD FILE EXTENSIONS 



Table D-1 (Cont.) 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 


BAG 


Binary 


Output from BASIC compiler 


BAK 


ASCII 


Backup file from TECO or 
LINED 


BAS 


ASCII 


Source file in BASIC 
language 


BCM 


ASCII 


Listing file created by 
FILCOM (binary compare) 


BCP 


ASCII 


Source file in BCPL language 


BIN 


Binary 


Binary file 


BLB 


ASCII 


Blurb file 


BLI 


ASCII 


Source file in BLISS 
language 


BOX 


ASCII 


Output of box program 
picture for use in 
specifications and manuals 


BUG 


Binary 


Saved to show a program 
error 


BWR 


ASCII 


Beware file listing warnings 
about a file or program 


CAL 


Binary 


CAL data and program files 


CBL 


ASCII 


Source file in COBOL 
language 


CCL 


ASCII 


Alternate convention for 
command file 


ceo 


ASCII 


Listing of modifications to 
nonresident software 


CDP 


ASCII, Binary 


Spooled output for card 
punch 


CED 


ASCII 


Input to COPYED 


ATO 


ASCII 


OPSER automatic command file 


CFC 


ASCII 


Compressed file compare. 
Group of .SCM files combined 
with PIP. 


CHN 


Binary 


CHAIN file 
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Table D-1 (Cont.) 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 


CKP 


Binary 


Checkpoint core image file 
created by COBOL object-time 
system 


CMD 


ASCII 


Command file 


CMP 


ASCII 


Complaint file by GRIPE 


COR 


ASCII 


Correction file for SOUP 


CRF 


ASCII 


CRF (cross-reference) input 
file 


CTL 


ASCII 


Batch control file 


DAE 


Binary 


DAEMON-taken core dump file 


DAT 


ASCII, Binary 


Data (FORTRAN) file 


DCT 


ASCII 


Dictionary of words 


DDT 


ASCII 


Input file to FILDDT 


DIR 


ASCII 


Directory listing from 
DIRECT command 


DMP 


ASCII 


COBOL compiler dump file 


DOC 


ASCII 


Listing of modifications to 
the most recent version of 
the software 


DRW 


Binary 


Drawing for VBIOC drawing 
system 


DSE 


ASCII 


Directory sorted by 
extension 


DSF 


ASCII 


Directory sorted by filename 


ERR 


ASCII 


Error message file 


EXE 


Binary 


Executable program (created 
by SAVE or SSAVE command) 


F4 


ASCII 


Source file in F40 (FORTRAN) 
language 
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Table D-1 (Cent.) 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 


FAI 


ASCII 


Source file in FAIL language 


FCL 


ASCII 


Source file in FOCAL 
language 


FFS 


ASCII 


Fast FORTRAN stream 


FLO 


ASCII 


English-language flowchart 


FOR 


ASCII 


Source file in FORTRAN 
language 


FRM 


ASCII 


Blank form for handwritten 
records 


FTP 


ASCII 


FORTRAN test programs 


FUD 


ASCII 


FUDGE2 listing output 


GND 


ASCII 


List of ground pins for 
automatic wirewrap 


HGH 


Binary 


Nonsharable high segment of 
a two-segment program 
(created by OSAVE command) 


HLP 


ASCII 


Help files containing switch 
explanations and so forth 


IDA 


Binary 


COBOL ISAM data file 


IDX 


Binary 


Index file of a COBOL ISAM 
file 


INI 


ASCII, Binary 


Initialization file 


LAP 


ASCII 


Output from the LISP 
compiler 


LIB 


ASCII 


COBOL source library 


LOG 


ASCII 


Batch, OPSER, or LINK log 
file 


LOW 


Binary 


Low segment of a two-segment 
program (created by OSAVE or 
OSSAVE command) 


LPT 


ASCII 


Spooled output for line 
printer 


LSD 


ASCII 


Listing output from DUMP 
program 
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Table D-1 (Cont.) 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 


LSP 


ASCII 


Source file in some LISPs 


LST 


ASCII 


Listing data created by 
assemblers and compilers 


MAC 


ASCII 


Source file in MACRO 
language 


MAN 


ASCII 


Manual (documentation) file 


MAP 


ASCII 


LINK map file 


MEM 


ASCII 


Memorandum file 


MIC 


ASCII 


MIC control file 


MID 


ASCII 


Source file in MIDAS (MIT 
Assembler) language 


MIM 


Binary 


Snapshot of MIMIC simulator 


MSB 


Binary 


Music compiler binary output 


MUS 


ASCII 


Music compiler input 


N 


ASCII 


Source file in NELIAC 
language 


NEW 


All 


New version of a program or 
file 


OBJ 


Binary 


PDP-11 relocatable binary 
file 


OLD 


ALL 


Old version of a program or 
file 


OPR 


ASCII 


Installation and assembly 
instructions 


OVR 


Binary 


COBOL overlay file 


OVL 


Binary 


LINK overlay file 


Pll 


ASCII 


Source program in MACYll 
language 


PAK 


ASCII 


Files compressed by PACK. TEC 
to save disk space 


PAL 


ASCII 


Source file in PALIO (PDP-8 
assembler) 
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Table D-1 (Cont.) 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 


PCO 


ASCII 


Program change order 


PLl 


ASCII 


Source file in PL/1 language 


PLM 


ASCII 


Program logic manual PLO 
Binary Compressed plot 
output 


PLT 


ASCII 


Spooled output for plotter 


PPL 


ASCII 


Source file in PPL language 


PTP 


ASCII, Binary 


Spooled output for 
paper-tape punch 


Qxt 


ASCII 


SOS backup file 


QUD 


ASCII, Binary 


Queued data file 


QUE 


Binary 


Queue request file 


QUF 


Binary 


Master queue and request 
file 


RAM 


ASCII 


TOPS-10 microcode 


REL 


Binary 


Relocatable binary file 


RIM 


Binary 


RIM loader file 


RMT 


Binary 


Read-in mode (RIM) format 
file (PIP) 


RNB 


ASCII 


RUNOFF input for producing a 
.BLB file 


RNC 


ASCII 


RUNOFF input for producing a 
.ceo file 


RND 


ASCII 


RUNOFF input for producing a 
.DOC file 


RNE 


ASCII 


RUNOFF input for producing 
an .ERR error-message text 
file 


RNH 


ASCII 


RUNOFF input for producing a 
.HLP file 


RNL 


ASCII 


RUNOFF input for producing a 
.PLM file 


RNM 


ASCII 


RUNOFF input for producing a 
.MAN file 
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Table D-1 (Cont.) 
Standard File &xtensions 



File Extension 


Kind of File 


Meaning 


RNO 


ASCII 


RUNOFF input for producing a 
.MEM file 


RNP 


ASCII 


RUNOFF input for producing 
an .OPR file 


RNS 


ASCII 


RUNOFF input for producing a 
.STD file 


RSP 


ASCII 


SCRIPT response time log 
file 


RSX 


All 


Files for RSX-11 


RTB 


Binary 


Read-in mode (RIMIOB) format 
file (PIP) 


SAI 


ASCII 


Source file in SAIL language 
SAV Binary Low segment from 
a one-segment program 
(created by OSAVE command) 


SCD 


ASCII 


Differences in directory 


SCM 


ASCII 


Listing file created by 
FILCOM (source compare) 


SCF 


ASCII 


SCRIPT control file 


SEQ 


ASCII, SIXBIT 


Sequential COBOL data file, 
input to ISAM program 


SFD 


Binary 


Subfile directory (reserved 
usage) 


SHR 


Binary 


Sharable high-segment file 
of a two-segment program 
(created by OSSAVE command) 


SIM 


ASCII 


Source file in SIMULA 
language 


BMP 


ASCII 


Source file in SIMPLE 
language 


SNO 


ASCII 


Source file in SNOBOL 
language 


SNP 


ASCII 


Snapshot of disk by DSKLST 
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Table D-1 (Cont.) 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 




SPC 


ASCII 


Functional or design 
specification document 


SPD 


ASCII 


Dictionary for SPELL program 


SPM 


ASCII 


File of misspelled 
SPELL program 


words for 


SPT 


ASCII 


SPRINT-created fil 


es 


SPU 


ASCII 


File of uppercase 
SPELL program 


words for 


SPX 


ASCII 


File of exception (error) 
lines for SPELL program 


SRC 


ASCII 


Source files 




STD 


ASCII 


Standards 




SVE 


Binary 


•SAVed file from 
user monitor 


a single 


SYM 


Binary 


LINK symbol file 




SYS 


Binary 


Special system fil 


es 


TEC 


ASCII 


TECO macro 




TEM 


ASCII, Binary 


Temporary files 




TMP 


ASCII, Binary 


Temporary files 




TPB 


ASCII 


Typeset input for 
a .BLB file 


producing 


TPC 


ASCII 


Typeset input for 
a .ceo file 


producing 


TPD 


ASCII 


Typeset input for 
a .DOC file 


producing 


TPE 


ASCII 


Typeset input for 
error message text 


producing 


TPH 


ASCII 


Typeset input for 
a .HLP file 


producing 
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Table D-1 (Cont.) 
Standard File Extensions 



File Extension 


Kind of File 


Meaning 




TPL 


ASCII 


Typeset input for 
a logic manual 


producing 


TPM 


ASCII 


Typeset input for 
a .MAN file 


producing 


TPO 


ASCII 


Typeset input for 
a programming spe 


producing 
cif ication 


TPP 


ASCII 


Typeset input for 
an .OPR file 


producing 


TST 


All 


Test data 




TXT 


ASCII 


Text file 




UFD 


Binary 


User file 
(reserved usage) 


directory 


UPD 


ASCII 


Updates flagged 
(FILCOM) 


in margin 


VMX 


Binary 


Expanded save fil 
at a location g 
zero and used as 
support program 
memory 


e starting 

reater than 

a special 

for virtual 


WCH 


ASCII 


SCRIPT monitor (WATCH) file 


WRL 


ASCII 


Wirelist 




XOR 


Binary 


Module data for XOR tester 


XPN 


Binary 


Expanded save f 
and LINK-10) 


ile (FILEX 


Zxt 


ASCII 


SOS original file 
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APPENDIX E 
SOS ERROR MESSAGES 



In the course of using SOS, you will probably encounter some error 
messages. An error message preceded by a question mark (?) indicates 
a fatal error. The fatal error may stop SOS without saving your file 
or it may continue with the SOS program using other options or 
commands then the one that caused the error. If you lose your file or 
edits because of a fatal error, you may recover using your most recent 
backup version of your file. An error message preceded by a percent 
sign (%) indicates a warning or information message. With the warning 
message, you may take the recommended corrective action and then 
reissue the command, or you may bypass the message as information 
given due to an edit to your file. 
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SOS ERROR MESSAGES 



Novice: ?BAD "BASIC" PILE FORMAT 



Expert: ?BBF 
Explanation: 

Solution: 



When you attempted to edit a BASIC program file, SOS 

found no BASIC line numbers in the input file or double 

sets of line numbers. The SOS program terminates 
immediately. 

Start SOS, but do not specify the BASIC option. Edit 
the BASIC file to fix the format or recreate the BASIC 
program file. 



Novice: 7DEVICE INPUT ERROR 



Expert: ?DIE 
Explanation: 

Solution: 



This message may be due to a hardware error or 
malfunction, or possibly a monitor error. The SOS 
program terminates immediately. 

Contact the operator to try to solve the problem if 
this message recurs. You may have to restore your 
file(s) from a recent backup. 



Novice: 7DEVICE NOT AVAILABLE 



Expert: 7DNA 
Explanation: 



Solution: 



You have issued a List command from SOS, but there is 
no line printer available. With this message you may 
get a Continued by Operator message, because the List 
command attempts to print on any available printer. 

If there is no line printer available, issue the 
TOPS-10 command ASSIGN DSK LPT or SET SPOOL LPT before 
you start the SOS session. With the ASSIGN DSK LPT 
command, the List command will create a .LPT file in 
your directory to be printed later. With the SET SPOOL 
LPT command, the List command will spool your output 
and print it when a line printer becomes available. 



Novice: 7DEVICE OUTPUT ERROR 



Expert: 7DDE 
Explanation: 

Solution: 



This error may be a hardware error or malfunction, or 
possibly a monitor error. The SOS program terminates 
immediately. 

Contact the operator to try to solve the problem if 
this message recurs. You may have to restore your 
file(s) from a recent backup. 
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SOS ERROR MESSAGES 

Novice: ?FILE WRITE PROTECTED, TRY ANOTHER NAME 

Expert: 7FILE WRITE PROTECTED, TRY ANOTHER NAME 

Explanation: This error occurs when you attempt to save your file 
with a new file specification which already exists and 
is write-protected. SOS will prompt you with the word 
FILE: . 

Solution: Specify a new filename and file extension that does not 
exist, or issue the TOPS-10 command RENAME to reset the 
protection code to less than 400. 

Novice: 7ILLEGAL UUO 

Expert: 7ILUU0 

Explanation: This is an internal SOS error. Your edits will be lost 
on this fatal error and the SOS program will terminate 
immediately. 

Solution: Contact the operator to try to restore your file or use 
the backup file with the .Qxt or .Zxt file extension to 
restore your file. 

Novice: ? INDIRECT READ ERROR 

Expert: ?CMERR 

Explanation: When you gave an indirect command (@) , there was a read 
error on the device on which the indirect command file 
resides. SOS stops taking commands from the file. 

Solution: Contact the operator to try to restore your indirect 
command file or use the backup file with the file 
extension .Qxt or .Zxt, or recreate the indirect file. 

Novice: 7INTERNAL CONFUSION 

Expert: ?ICN 

Explanation: There is an internal problem with SOS and your edits 
will be lost. 

Solution: Contact the operator to try to restore your file or use 
the backup file with the file extension of .Qxt or 
.Zxt. 

Novice: ? OPTION NOT FOUND 

Expert: ? OPTION NOT FOUND 

Explanation: When you gave the /OPTION:name command, you specified a 
pointer name that does not exist in your SWITCH.INI 
option file as having a list of options associated with 
it. 

Solution: Check your SWITCH.INI file to make sure that you have 
such a name to specify a list of options. 
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SOS ERROR MESSAGES 

Novice: ? SYNTAX ERROR IN DEFAULT OPTIONS 

Expert: ? SYNTAX ERROR IN DEFAULT OPTIONS 

Explanation: When you started an SOS session, your SWITCH.INI option 
file specified one or more options that are misspelled 
or contain incorrect punctuation. SOS ignores the 
options set in your SWITCH.INI file and prompts you 
with the word FILE: to respecify the file 
specification and options you want. 

Solution: Start SOS to edit your SWITCH.INI option file to 
correct the spelling or punction errors. You will have 
to rename the SWITCH.INI file before editing it as the 
same error would otherwise occur when you start SOS. 

Novice: ? SYNTAX ERROR IN OPTION FILE 

Expert: ? SYNTAX ERROR IN OPTION FILE 

Explanation: When you started an SOS session or set a series of 
options with the /OPTION: name command, SOS encountered 
a spelling or punctuation error in one or more options 
in your SWITCH.INI option file. 

Solution: Start SOS to edit your SWITCH.INI option file to 
correct the spelling or punctuation errors. You will 
have to rename the SWITCH.INI file before editing it as 
the same error would otherwise occur when you start 
SOS. 

Novice: %BACKUP FILE PROTECTED - IGNORED 

Expert: %BACKUP FILE PROTECTED - IGNORED 

Explanation: The backup file (.Qxt) was protected from being 
updated, but SOS ignored this protection and created a 
new backup file. 

Solution: To correct this error, change the protection number of 
the file with the TOPS-10 command RENAME, so that the 
protection number will be less than 400. 

Novice: %FILE NOT FOUND 

Expert: %FNF 

Explanation: When you gave a Copy command to copy text from another 
file, you specified a filename and/or file extension 
that did not exist. 

Solution: Examine the directory that contains the file you are 
trying to copy from to obtain the correct filename and 
file extension, and then reissue the Copy command. 
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SOS ERROR MESSAGES 

Novice: %ILLEGAL COMMAND 

Expert: %ILC 

Explanation: This message indicates that you typed an incorrect 
syntax to an SOS command. Most likely the punctuation 
or spelling of the SOS command is incorrect. 

Solution: Examine the command and reissue it. 

Novice: %ILLEGAL LINE FORMAT 

Expert: %ILFMT 

Explanation: SOS found a line with a nonstandard internal format. 
Most likely this file is not meant for editing with 
SOS. 

Solution: Give an EQ command to return to the TOPS-10 command 
level. If you must edit this file, contact the 
operator or system manager and describe your problem. 

Novice: %ILLEGAL REPLACEMENT ON INSERT 

Expert: %ILR 

Explanation: You have tried to insert a line that already exists in 
the file and SOS cannot fit a line between the 
indicated line and the next line. 

Solution: To insert that line, give the Number command to 
renumber your file, find your place again, and then 
reissue the Insert command. 

Novice: % ILLEGAL REPLACEMENT STRING 

Expert: %IRS 

Explanation: A Substitute command has been given specifying a 
replacement-string with illegal characters or an 
illegal format. 

Solution: Reissue the Substitute command with the proper 
replacement-string . 

Novice: % ILLEGAL SEARCH STRING 

Expert: %ISS 

Explanation: A Find or Substitute command has been given specifying 
a search-string with illegal characters or an illegal 
format. 

Solution: Reissue the Find or Substitute command with the proper 
search-string . 
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SOS ERROR MESSAGES 

Novice: % ILLEGAL TRANSFER DESTINATION 

Expert: %ITD 

Explanation: In giving the Transfer command, you have indicated a 
destination line that either does not exist or that is 
in the source range. 

Solution: Examine the Transfer*- command or your file and reissue 
the Transfer command again with the correct 
destination. 

Novice: %INDIRECT EOF 

Expert: %CMEND 

Explanation: This is an information message that appears on your 
terminal when an indirect command file has completed 
execution. 

Solution: Not applicable. 

Novice: %INSUFFICIENT CORE AVAILABLE 

Expert: %NEC 

Explanation: A Copy or Transfer command has been given to copy or 
transfer a source-range of lines that exceeds the 
memory alloted to the SOS session. 

Solution: Reissue the Copy or Transfer command with a smaller 
source-range; repeat the command until the original 
source-range is completely copied or transferred. 

Novice: %LINE TOO LONG 

Expert: %LTL 

Explanation: SOS permits lines up to 497 characters in length, but 

you have exceeded this length. The SOS command that 

caused this error is canceled and the input from the 
SOS command is not done. 

Solution: Try inputting, inserting, or joining the contents on 
more than one line. 
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SOS ERROR MESSAGES 



Novice: %NARGIN ERROR 



Expert: %MAR 
explanation: 

Solution: 



This error will occur only when the Justification 
command has been assembled for your installation of 
SOS. The RMAR option value has been set to a value 
that is less than the LMAR option. 



Reset the RMAR option to be greater than the 
option, so that justification can take place. 



LMAR 



Novice: %N0 NEXT LINE 
Expert: %NNN 
Explanation: 



Solution: 



You have attempted to print on your terminal the next 
line in the file, but you are positioned at the end of 
the file. 

Move the pointer so that you are not at the end of your 
file, or press ESCape to print the previous line. 



Novice: %N0 STRING GIVEN 
Expert: %NSG 
Explanation: 



Solution: 



A Find or Substitute command has been given without 
specifying the string of characters to be found; the 
command has been canceled. 

Reissue the Find or Substitute command specifying a 
search-string. 



Novice: %N0 SUCH LINE(S) 

Expert: %NLN 

Explanation: The line(s) you indicated in the last SOS command do 
not exist in your file. 



Solution: 



Reissue the SOS command with the proper line number (s). 



Novice: %N0 SUCH PAGE 

Expert: %NSP 

Explanation: The page you indicated in the last SOS command does not 
exist in your file. 



Solution: 



Reissue the SOS command with the proper page number. 
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SOS ERROR MESSAGES 

Novice: %OUT OF ORDER 

Expert: %ORDER 

Explanation: This message will appear (1) during a Copy, Number, or 
Transfer command if SOS had to insert line number (s) 
which were not in numerical order; (2) when you kill 
page marks or delete page contents and the line numbers 
are not in numerical order after the Kill or Delete 
command has executed. 

Solution: To maintain the integrity of your file, IMMEDIATELY 
give a Number command to put the lines in numerical 
order. If you receive this message again, issue the 
Number command again with a smaller increment. 

Novice: %SEARCH FAILS 

Expert: %SRF 

Explanation: In a Find or Substitute command, the search-string has 
not been found and your place in the file has not been 
changed. 

Solution: Examine the Find or Substitute command and reissue it 
with a proper search-string that can be found. 

Novice: %SEARCH STRING TOO COMPLEX 

Expert: %STC 

Explanation: A Find or Substitute command with the /C128 option set 
has been given with too many special characters so that 
the search-string becomes too complex. 

Solution: Examine the Find or Substitute command and reissue it 
with the proper special characters in the 
search-string . 

Novice: %STRING TOO LONG 

Expert: %STL 

Explanation: The string of characters in a Find or Substitute 
command is longer than the maximum allowed by the SOS 
program. The maximum allowed is 200 characters for 
each Find or Substitute command. 

Solution: Reissue the Find command with less than the 200 maximum 
characters allowed in the search-string (s) . Reissue 
the Substitute command with less than the 200 maximum 
characters allowed in the search-string (s) and 
replacement-str ing (s) . 
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SOS ERROR MESSAGES 

Novice: %TEXT INSERTED AT END OF FILE 

Expert: %TEXT INSERTED AT END OF FILE 

Explanation: This error message appears after you issued a Transfer 
command where the transferred range of line/page 
numbers have been placed at the end of your file. 

Solution: When examining your file, you may find an additional 
page mark in your file that you may wish to delete 
(Kill command) . 

Novice: %T00 MANY STRINGS 

Expert: %TMS 

Explanation: In giving a Find or Substitute command in their 
extended formats, you have specified more than six 
separate strings. 

Solution: The maximum allowed by the SOS program is six separate 
search-strings (Find and Substitute commands) and six 
separate replacement-strings (Substitute command) . 
Reissue the Find or Substitute command with six or less 
separate strings. 

Novice: % WARNING - COPY ASSUMED 

Expert: % WARNING - COPY ASSUMED 

Explanation: You have issued a Transfer command in the same format 
as a Copy command to transfer lines from another file. 
However, SOS does not transfer lines from another file. 
Thus, SOS assumes that you have decided to change the 
Transfer command to a Copy command so it copied the 
specified range of line/page numbers. 

Solution: Since SOS performs the Transfer command as a Copy 
command, you may issue an EQ to the C* prompt, delete 
the range of lines that were copied, or keep the change 
you have made. The Transfer command cannot delete 
line/page numbers from another file. 

Novice: %WRAP AROUND 

Expert: %WAR 

Explanation: In renumbering the file, SOS reached its maximum line 
number of 99999 (or 99900 by default) . The contents of 
the lines are in their proper order, but the line 
numbers are not in an ascending sequence. 

Solution: Give the Number command with a smaller number to 
increment the line numbers. 
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100, 
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A, 

DECIDE response, 4-15 
A command, 5-17 
A option F command, 5-43 
A option N command, 5-75 
A response of D option, 

5-86 
Alter-A command, 5-17, A-4 
Alter mode, 1-8, A-4 
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5-20, A-8 
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5-19, A-8 
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5-21, A-9 
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5-21, A-4 
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5-22, A-4 
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5-22, A-4 
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5-23, A-5 
instructions, 

5-17, 5-18 
J instruction, 

5-24, A-5 
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5-24, A-5 
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L instruction, 

5-25, A-6 
P instruction, 

5-25, A-6 
Q instruction, 

5-25, A-6 
R instruction, 

5-26, A-7 
S instruction, 

5-27, A-7 
V instruction, 

5-28 
W instruction, 

5-28, A-7 
X instruction, 

5-29, A-7 
of X command, 
5-106 
ANSI character names, C-3 
ANSI name descriptions, C-3 
ANSI names, 6-8 
Argument 

. (Move) command, 5-7 

/ (Set) command, 5-9 

= (Give) command, 5-11 

@ (Indirect) command, 5-13 

A command, 5-17 

C command, 5-31 

D command, 5-37 

F command, 5-43 

I command, 5-57 

J command, 5-61 

JC,JL,JR,JU,JW 

command, 5-63 
K command, 5-69 
L command, 5-71 
M command, 5-73 
R command, 5-81 
S command, 5-85 
T command, 5-93 
VL,VU,VV 

command, 5-99 
X command, 5-105 
Arguments, 

content specification, 

8-1 
line contents, 8-1 
recalling, 1-11 
SOS command, 5-2 
SOS command recalling, 
1-11 
Arithmetic expressions, 3-4 
Asterisk character, 3-3 
Auto-save, 4-25, 4-26, 
4-55, 9-2 
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B option E command, 5-39 
B option G command, 5-47 
B option W command, 5-101 
Backup, 

SOS file, 9-1 
%BACKUP FILE PROTECTED, 

5-40, 5-48, 5-102, 
E-4 
Backup files, 10-9 

SOS, 9-6, 9-7, 9-8 
?BAD "BASIC" FILE FORMAT, 

4-10, E-2 
BAK option, 4-8, B-2 
BASIC option, 4-9, B-2 
?BBF, E-2 

BIG option, 4-11, B-2 
<BS>, 2-5 
Buffers, 

SOS files and, 10-1 



C argument JC command, 5-63 
C command, 5-31, 5-32, 

5-33, 5-34 
C command file 

specifications, 5-32, 
5-33 
C instruction. 

Alter mode, 5-21, A-4 
C128, 

special mode, 7-2 
C128 character 

representation, 6-8 
C128 mnemonics, 7-3, 7-4, 

7-5, 7-6 
C128 option, 4-13, 4-30, 

4-62, 5-88, 6-4, 
6-5, 6-7, 7-1, 
B-2 
C64 option, 4-12, 6-4, 

6-5, B-2 
Carriage return, 3-1 
CASE option, 4-14, B-2 
Character , 

!, 3-3, 3-4 
*, 3-3 
+ , 3-4 
-, 3-4 
. , 3-2 
", 3-3 

asterisk, 3-3 
exclamation, 3-3, 3-4 
minus, 3-4 
period, 3-2 
plus, 3-4 
up-arrow, 3-3 
Character match, 7-3, 
7-4 
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ANSI, C-3 
Character representation, 

C128, 6-8 
Character table, 

SOS, C-1, C-2 
Characteristics, 

SOS command, 5-2 

terminal, 2-1 
Characters, 

illegal, 1-2 

lowercase, 6-1 

special, 6-1 

special line number, 
3-2 

special matching, 5-88, 
7-2 

special replacement, 5-88, 
7-6 

uppercase, 6-1 
%CMEND, 2-9, E-6 
7CMERR, E-3 
7CMLNPC NO PREVIOUS COMMAND, 

5-48 
Code, 

protection, 2-2 
Command, 2-4 

. (Move) , 5-7, A-3 

/ (Set) , 1-4, 4-6, 5-9, 
A-3 

= (Give) , 5-11, A-3 

@ (Indirect) , 2-8, 5-13, 
A-3 

<CTRL/C>, A-1 

<CTRL/G>, A-2 

<CTRL/R>, A-2 

<CTRL/U>, A-2 

<DEL> DELETE, A-1 

<ESC> ESCAPE, 5-5, A-2 

<LF> LINEFEED, 5-3, A-2 

ALTER-A, 5-17, A-4 

COPY-C, 5-31, A-9, A-10 

DELETE-D, 5-37, A-10 

END-E, 5-39, A-10 

ES, 4-61 

FIND-F, 4-60, 5-43, 7-1, 
A-11 

GO-G, 4-54, 5-47, A-11 

GS, 4-61 

HELP-H, 5-51, A-12 

INSERT-I, 5-57, A-12 

JC, 5-63, A-13 

JL, 5-63, A-13 

JOIN-J, 5-61, A-12 

JR, 5-63, A-13 

JU, 5-63, A-13 

JUSTIFICATION, 5-63, 
A-13 

JW, 5-63, A-13 
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KILL-K, 5-69, A-13 

LIST-L, 5-71, A-14 

MARK-M, 5-73, A-14 

NA, 5-76 

NP, 5-77 

NUMBER-N, 5-75, A-14 

PRINT-P, 5-79, A-15 

R SOS, 1-13 

REPLACE-R, 5-81, A-15 

SUBSTITUTE-S, 4-60, 5-85, 
7-1, A-15 

TRANSFER-T, 5-93, A-16 

INVERT-V, 5-99, A-16 

VL, A-16 

VU, A-16 

VV, A-16 

WORLD-W, 4-55, 4-61, 
5-101, A-17 

WS, 4-61 

EXTEND-X, 5-105, A-17 
Command file, 

indirect, 2-7 
Command format, 

SOS, 1-4 
Command format definition, 

7-1 
Command formats, 2-1 
Command level, 

SOS, 2-2 
Command level format, 

SOS, 2-4 
Commands, 

giving, 2-1 

stopping, 2-5 
Commands in indirect file, 

giving, 2-7 
Content specification 
arguments, 8-1 
line, 8-1 
Contents, 

line, 2-3 
Control characters, 6-8 
Control modes, 

SOS, 1-6 
COPY-C command, 5-31, A-9, 

A-10 
Correcting typing errors, 

2-5 
Creating a file, 1-1 
Creating indirect file, 2-7 
Creating multipage files, 

3-5 
<CTRL/C>, 1-2, 2-5, 2-6, 

9-11, A-1 
<CTRL/G>, 2-5, A-2 
<CTRL/R>, 2-5, A-2 
<CTRL/U>, 2-5, A-2 



<CTRL/U> instruction. 

Alter mode, 5-21, A-9 
Current file in memory, 
10-1 



D command, 5-37, 5-38 
D instruction. 

Alter mode, 5-22, A-4 
D option E command, 5-39 
D option G command, 5-47 
D option S command, 5-86 
D option W command, 5-101 
?DDE, E-2 
DECIDE option, 4-15, 4-16, 

B-2 
DECIDE responses, 4-15 
Default line number, 

SOS, 4-59 
Defaults, 

SOS, 6-1 
Definition, 

command format, 7-1 
<DEL>, 2-5 

DECIDE response, 4-15 
<DEL> command, A-1 
<DEL> instruction. 

Alter mode, 5-20, A-8 
<DEL> response of D option, 

5-86 
DELETE option, 4-17, B-2 
DELETE-D command, 5-37, 

A-10 
Deleting lines in multipage 

files, 3-10 
Deletion, 

page mark, 5-37 
DESCRIPTIONS, 

SOS COMMAND, 5-1 
Descriptions of options, 

4-7 
Dev:, 2-2 

?DEVICE INPUT ERROR, E-2 
7DEVICE NOT AVAILABLE, E-2 
PDEVICE OUTPUT ERROR, E-2 
Diagram, 

special character, 7-8, 
7-9, 7-10 
?DIE, E-2 

Directory path, 2-2 
DISK option, 4-18, B-2 
Disk quota, 9-9 
Disk space, 

insufficient, 9-9 
?DNA, E-2 
DPY option, 4-19, 4-20, B-2 
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DECIDE response, 4-15 

E command, 5-39, 5-40, 5-41 
your files after, 10-9 

E instruction. 

Alter mode, 5-22, A-4 

E option F command, 5-44 

E option S command, 5-86 

E response of D option, 
5-86 

EB command, 1-4, 9-5 

ED command, 1-4, 5-39, 9-6 

Edit mode, 1-9 

setting options, 4-6 

Editing, 

file backup while, 9-2 

Editing a file, 1-9 

Editing file in another 
directory, 1-11 

Editing multipage files, 
3-7 

END-E command, 5-39, A-10 

Ending SOS, 1-4, 9-3, 9-4, 
9-5, 9-6 

EOF, 

%INDIRECT, 2-9 

EQ command, 1-4, 5-39, 9-6 

Error messages, 
%, E-1 
?, E-1 
SOS, E-1 

ERROR option, 4-21, B-2 

Errors, 

correcting typing, 2-5 

ES command, 1-4, 4-61, 5-39, 
9-4 

<ESC> command, 5-5, 5-6, 

5-79, 5-106, A-2 

Example, option 

. (Period) option, 4-48 
BAK option, 4-8 
BASIC option, 4-9 
BIG option, 4-11 
C128 option, 4-13 
C64 option, 4-12 
CASE option, 4-14 
DECIDE option, 4-15 
DELETE option, 4-17 
DISK option, 4-18 
DPY option, 4-19 
ERROR option, 4-21 
EXPERT option, 4-22 
INCREMENT option, 4-23 
ISAVE option, 4-25 
LENGTH option, 4-27 
LMAR option, 4-28 
LOCATION option, 4-29 
LOWER option, 4-30 



Example, option (Cont.) 
M33 option, 4-33 
M37 option, 4-34 
MAXLN option, 4-36 
NAME option, 4-37 
NOBAK option, 4-38 
NODECIDE option, 4-39 
NODELETE option, 4-40 
NONSEPARATORS option, 4-41 
NONUMBER option, 4-42 
NOVICE option, 4-44 
NUMBER option, 4-45 
OLD option, 4-46 
OPTION option, 4-47 
PLINES option, 4-49 
PMAR option, 4-50 
READONLY option, 4-51 
RMAR option, 4-53 
RUN option, 4-54 
SAVE option, 4-55 
SEPARATORS option, 4-56 
SEQUENCE option, 4-57 
START option, 4-58 
STEP option, 4-59 
STRING option, 4-60 
UNSEQUENCE Option, 4-61 
UPPER option, 4-62, 4-63 

Examples, 

line contents 
specification, 8-2, 8-3, 
8-4 
SOS command, 5-2 

Examples, command 

. (Move) command, 5-8 

/ (Set) command, 5-10 

= (Give) command, 5-11 

(3 (Indirect) command, 5-14 

<LF> command, 5-3 

<ESC> command, 5-6 

C command, 5-35 

C128 mnemonics, 7-3 

7-4, 7-5 
D command, 5-38 
E command, 5-41 
F command, 5-46 
G command, 5-49 
H command, 5-51 
I command, 5-59 
J command, 5-61 
JC command, 5-63, 5-65 
JL command, 5-65 
JR command, 5-66 
JU command, 5-66 
JW command, 5-67 
K command, 5-69, 5-70 
L command, 5-72 
M command, 5-74 
N command, 5-78 
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P command. 


5-80 






R command, 


5-82, 


5- 


•83 


S command. 


5-89, 


5- 


•90, 


5-91, 7-5, 7- 


-7 




S command line 






contents, 


r 8-5, 


8- 


•6, 8-7, 


8-8 








T command. 


5-95, 


5- 


•96, 


5-97 






V command , 


5-100 






W command. 


5-103, 


c 
r - 


i-104 


X command. 


5-107 






Exclamation character. 


3-3, 


3-4 








EXPERT option. 


4-22, 


5- 


•37, 


B-2 








Expressions, 








arithmetic , 


, 3-4 






.ext, 2-2 








Extended characteristics, 


C command, 


5-32, 


5- 


•33 


F command. 


5-45 






N command. 


5-76 






S command , 


5-87 






Extension, 








.Qxt file. 


4-38, 


9- 


•3 


.Zxt file. 


4-46, 


IC 


1-13 


Extensions, 








standard f: 


Lie, Appendix D 



F command, 5-43, 5-44, 5-45 
File, 

creating a, 1-1 

creating indirect, 2-7 

editing a, 1-9 

indirect command, 2-7 

nnnSOS.TEM, 10-2 

nnnSOS.TMP, 10-3 

renumbering your, 3-15 

saving with no backup, 
9-5 

saving your, 9-3 

SWITCH.INI option, 1-12, 
4-47 

.TEM, 10-1, 10-2, 10-14 

.TMP, 10-1, 10-3, 10-14 

using indirect, 2-8 
File backup, 

SOS, 9-1 
File backup while editing, 

9-2 
File backup while inputting, 

9-2 
File extension, 

.Qxt, 4-38, 9-3 

.Zxt, 4-46, 10-13 



File extension 

specification, 1-2 
File extensions, 

standard. Appendix D 
File in another directory, 

editing, 1-11 
%FILE NOT FOUND, 5-34, E-4 
File protection code, 9-6 
File specifications, 1-2, 
4-37, 4-54 

C command, 5-32, 5-33 

E command, 5-39 

G command, 5-47 

input, 2-1 

output, 2-1 

W command, 5-101 
?FILE WRITE PROTECTED, 5-40, 

5-48, 5-103, E-3 
FILE:, 1-1 

Filename specification, 1-2 
Files, 

backup, 10-9 

creating multipage, 3-5 

deleting lines in 
multipage, 3-10 

editing multipage, 3-7 

multipage, 3-13, 3-14 

SOS backup, 9-6, 9-7, 9-8 

temporary, 10-1 

using multipage, 3-1 
Files after E command, 10-9 
Files after G command, 10-9 
Files after W command, 10-9 
Files and buffers, 

SOS, 10-1 
Files with line numbers, 

saving, 9-3 
Files without line numbers, 

saving, 9-4 
Filnam, 2-2 
FIND-F command, 4-60, 5-43, 

7-1, A-11 
Finding status of options, 

4-7 
Finish-here string, 8-2 
%FNF, E-4 
Form feed, 3-1 
Formats, 

. (Move) command, 5-7 

/ (Set) command, 5-9 

= (Give) command, 5-11 

@ (Indirect) command, 5-13 

<LF> command, 5-3 

<ESC> command, 5-5 

A command, 5-17 

C command, 5-31 

command, 2-1 

D command, 5-37 

E command, 5-39 
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Formats, (Cont.) 

F command, 5-43 

G command, 5-47 

H command, 5-51 

J command, 5-61 

JC,JL,JR,JU,JW 
command, 5-63 

K command, 5-69 

L command, 5-71 

line contents command, 
8-1, 8-2 

M command, 5-73 

N command, 5-75 

option, 4-1 

P command, 5-79 

R command, 5-81 

S command, 5-85 

SOS command, 5-2 

SOS command level, 2-4 

SOS input line, 2-3 

SOS page mark, 3-1 

SWITCH.INI file, 
line, 4-2 

T command, 5-93 

V command, 5-99 

W command, 5-101 

X command, 5-105 
Full file specifications, 

2-1 
Function, 

. (Move) command, 5-7 

. (Period) option, 4-48 

/ (Set) command, 5-9 

= (Give) command, 5-11 

@ (Indirect) command, 5-13 

<LF> command, 5-3 

<ESC> command, 5-5 

A command, 5-17 

BAK option, 4-8 

BASIC option, 4-9 

BIG option, 4-11 

C command, 5-31 

C128 option, 4-13 

C64 option, 4-12 

CASE option, 4-14 

D command, 5-37 

DECIDE Option, 4-15 

DELETE option, 4-17 

DISK option, 4-18 

DPY option, 4-19 

E command, 5-39 

ERROR option, 4-21 

EXPERT option, 4-22 

F command, 5-43 

G command, 5-47 

H command, 5-51 

I command, 5-57 

INCREMENT option, 4-23 

ISAVE option, 4-25 



Function, (Cont.) 
J command, 5-61 
JC,JL,JR,JU,JW command, 5-63 
K command, 5-69 
L command, 5-71 
LENGTH option, 4-27 
LMAR option, 4-28 
LOCATION option, 4-29 
LOWER option, 4-30 
M command, 5-73 
M33 option, 4-33 
M37 option, 4-34 
MAXLN option, 4-36 
N command, 5-75 
NAME option, 4-37 
NOBAK option, 4-38 
NODECIDE option, 4-39 
NODELETE Option, 4-40 
NONSEPARATORS option, 4-41 
NONUMBER option, 4-42 
NOVICE option, 4-44 
NUMBER option, 4-45 
OLD option, 4-46 
OPTION option, 4-47 
P command, 5-79 
PLINES option, 4-49 
PMAR option, 4-50 
R command, 5-81 
READONLY option, 4-51 
RMAR option, 4-53 
RUN option, 4-54 
S command, 5-8 5 
SAVE option, 4-55 
SEPARATORS Option, 4-56 
SEQUENCE option, 4-57 
SOS command, 5-2 
START option, 4-58 
STEP option, 4-59 
STRING option, 4-60 
T command, 5-93 
UNSEQUENCE option, 4-61 
UPPER option, 4-62 
V command, 5-99 
W command, 5-101 
X command, 5-105 



G, 

DECIDE response, 4-15 
G command, 5-47, 5-48, 5-49 

your files after, 10-9 
G command file 

specifications, 5-47 
G response, 

WELL?, 9-10 
G response of D option, 
5-86 



Index- 6 



INDEX (CONT.) 



GB command, 5-47, 9-5 
GD command, 5-47, 9-6 
Giving commands, 2-1 
Giving commands in indirect 

file, 2-7 
Giving options, 4-5 
GO-G command, 4-54, 5-47, 

A-11 
GQ command, 5-47, 9-6 
GS command, 4-61, 5-47, 9-4 



H command, 5-51, 5-52, 5-53, 

5-54, 5-55 
HELP-H command, 5-51, A-12 
Hints, 

. (Move) command, 5-7 

/ (Set) command, 5-9 

@ (Indirect) command, 5-13 

A command, 5-17 

D command, 5-38 

E command, 5-39 

F command, 5-45 

G command, 5-47 

I command, 5-58 

K command, 5-69 

L command, 5-71 

M command, 5-73 

N command, 5-75 

P command, 5-79 

R command, 5-82 

SOS command, 5-2 

T command, 5-94 

W command, 5-101 



% 



command, 5-57, 5-58, 5-59 
instruction. 

Alter mode, 5-23, A-5 
ICN, E-3 
ILC, E-5 
ILFMT, E-5 

ILLEGAL CHAR IN CMD, 1-2 
llegal characters, 1-2 
ILLEGAL COMMAND, 4-7, 4-51, 
5-41, 5-48, 5-99, 
5-103, E-5 
ILLEGAL LINE FORMAT, E-5 
ILLEGAL REPLACEMENT ON 

INSERT, 5-58, E-5 
ILLEGAL REPLACEMENT STRING, 

E-5 
ILLEGAL SEARCH STRING, 

5-89, E-5 
ILLEGAL TRANSFER 

DESTINATION, 5-95, E-6 



? ILLEGAL UUO, E-3 
%ILR, E-5 
7ILUU0, E-3 
Including options in 

SWITCH.INI, 4-2 
INCREMENT option, 4-23, 

4-24, B-2 
Indirect command file, 2-7 
%INDIRECT EOF, 2-9, E-6 
Indirect file, 2-7, 2-8 

options in, 4-6 
7INDIRECT READ ERROR, E-3 
Input file specification, 

2-1 
Input level, 

SOS, 2-2 
Input line format, 

SOS, 2-3 
Input mode, 1-6, 1-7 
INPUT:, 1-1 
Inputting, 

file backup while, 9-2 
INSERT-I command, 5-57, 

A-12 
Insertion, 

page mark, 5-73 
Instructions, 

Alter mode, 5-17, 5-18 

Alter mode <CTRL/U>, 5-21, 
A- 9 

Alter mode <DEL>, 5-20, 
A- 8 

Alter mode <RET>, 5-19, 
A- 8 

Alter mode <SP>, 5-19, 
A- 8 

Alter mode <TAB>, 5-20, 
A- 8 

Alter mode C, 

Alter mode D, 

Alter mode E 

Alter mode I 

Alter mode J 

Alter mode K 

Alter mode L, 

Alter mode P 

Alter mode Q 

Alter mode R, 

Alter mode S 

Alter mode V, 

Alter mode W, 

Alter mode X, 

SOS command 
%INSUFFICIENT CORE, 5-34 
%INSUFFICIENT CORE 

AVAILABLE, 5-94, E-6 
Insufficient disk space, 
9-9 



, 5-21, 


A- 4 


, 5-22, 


A- 4 


, 5-22, 


A- 4 


, 5-23, 


A-5 


, 5-24, 


A-5 


, 5-24, 


A-5 


, 5-25, 


A- 6 


r 5-25, 


A- 6 


, 5-25, 


A- 6 


, 5-26, 


A- 7 


, 5-27, 


A- 7 


, 5-28 




, 5-28, 


A- 7 


, 5-29, 


A- 7 
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PINTERNAL CONFUSION, 4-10, 

E-3 
Introduction to the SOS 

program, 1-1 
%IRS, E-5 
ISAVE option, 4-25, 4-26, 

9-2, B-2 
%ISS, E-5 
%ITD, E-6 



J command, 5-61 
J instruction. 

Alter mode, 5-24, A-5 
JC command, 5-63, 5-65 

A-13 
JC,JL, JR, JU,JW command, 

5-63 
JC, JR, JL, JU, JW command, 

restrictions, 5-63 
JL command, 5-63, 5-65, 

A-13 
JOIN-J command, 5-61, A-12 
JR command, 5-63, 5-66, 

A-13 
JU command, 5-63, 5-66, 

A-13 
JUSTIFICATION command, 5-63, 
5-64, 5-65, 5-66, 
5-67, A-13 
JW command, 5-63, 5-67, 

A-13 



K command, 5-69, 5-70 
K instruction. 

Alter mode, 5-24, A-5 
KILL-K command, 5-69, A-13 
Killing page marks, 3-13 



Line contents, 2-3 

examples S command, 8-5, 
8-6, 8-7, 8-8 
Line contents arguments, 

8-1 
Line contents command 
formats, 8-1, 8-2 
Line contents specification 
examples, 8-2, 8-3, 8-4 
Line contents 

specifications, 4-42, 
4-60, 8-1 
Line contents SUBSTITUTE 

command, 8-5 
Line format, 

SOS input, 2-3 
Line format SWITCH.INI file, 

4-2 
Line number, 2-3 

SOS default, 4-58, 4-59 
special characters, 3-2 
Line numbers, 3-1 

renumbering, 3-14 
saving files with, 9-3 
saving files without, 9-4 
%LINE TOO LONG, 5-61, 5-63, 

E-6 
Line/page number symbols, 

A-1 
LINEFEED command, 

<LF>, 5-3 
LIST-L command, 5-71, A-14 
LMAR option, 4-28, 5-63, 

B-3 
LOCATION option, 4-29, B-3, 

10-2 
LOWER option, 4-30, 4-31, 
4-32, 6-4, 6-5, 
B-3 
Lowercase, 

typing, 6-3, 6-7 
Lowercase characters, 6-1 
%LTL, E-6 



L argument JL command, 5-63 
L argument V command, 5-99 
L command, 5-71, 5-72 
L instruction. 

Alter mode, 5-25, A-6 
LA36 terminal, 6-1, 6-6 
LENGTH option, 4-27, 5-63, 

B-3 
Levels, 

command, 2-2 
<LF> (Linefeed) command, 

5-3, 5-79, 5-106, 
A- 2 
Line, 2-4 



M command, 5-73, 5-74 

M33 option, 4-33, 6-1, B-3 

M37 option, 4-34, 4-35, 6-1, 

B-3 
%MAR, E-7 

%MARGIN ERROR, 5-63, E-7 
Mark page, 3-1 
MARK-M command, 5-73, A-14 
Marks, 

killing page, 3-13 
MASSIVE DELETE OK?, 3-11, 

4-44, 5-37, 5-82 
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Matching characters, 7-1, 
7-2, 7-3 

specification, 7-4 
Match-string, 7-1 
MAXLN option, 4-36, 5-63, 

8-1, B-3 
Memory, 10-1 

current file in, 10-1 
Memory buffer, 10-2 
Mnemonics, 

C128, 7-3, 7-4, 7-6 

examples C128, 7-5 
Mode, 

Alter, 1-8, A-4 

Edit, 1-9 

Input, 1-6 
Mode instructions. 

Alter, 5-17, 5-18 
Modes, 

SOS control, 1-6 
Multipage files, 3-13, 3-14 
Multipage files, 

creating, 3-5 

deleting lines in, 3-10 

editing, 3-7 

using, 3-1 
Multiple format in 

SWITCH.INI, 4-3 
Multiple line in SWITCH.INI, 
4-3 



N command, 5-75, 5-76, 

5-77, 5-78 
N option F command, 5-43 
N option S command, 5-86 
NA command, 5-76 
NAME option, 4-37, B-3 
Names, 

ANSI, 6-8 
%NEC, E-6 
%NLN, E-7 
%NNN, E-7 
No backup file, 

saving with, 9-5 
%N0 NEXT LINE, 5-61, E-7 
%N0 STRING GIVEN, 5-45, 

5-87, 5-89, E-7 
%N0 SUCH LINE(S) , 5-38, 

5-79, 5-82, 5-99, 

8-1, E-7 
%N0 SUCH PAGE, 5-58, 5-69, 

5-73, E-7 
NOBAK option, 4-38, 4-46, 

9-3, 9-8, 10-13, 

B-3 
NODECIDE option, 4-39, B-3 
NODELETE option, 4-40, B-3 



NONSEPARATORS option, 4-41, 

B-3 
NONUMBER option, 4-42, 4-43, 

B-3 
NOVICE option, 4-44, B-3 
NP command, 5-77 
%NSG, E-7 
%NSP, E-7 
Null, 3-1 
Number, 2-4 

NUMBER option, 4-45, B-3 
Number option F command, 

5-44 
Number option S command, 

5-86 
NUMBER-N command, 5-75, 

A-14 
Numbers, 

line, 3-1 
page, 3-1 



OLD option, 4-38, 4-46, 9-8, 

10-13, B-4 
Operation, 

SOS command, 5-2 
Operation C command, 5-32, 

5-33 
Operation X command, 5-105, 

5-106 
Option, 2-4 

. (Period) , 4-48, B-2 

BAK, 4-8, B-2 

BASIC, 4-9, B-2 

BIG, 4-11, B-2 

C128, 4-13, B-2 

C64, 4-12, B-2 

CASE, 4-14, B-2 

DECIDE, 4-15, 4-16, B-2 

DELETE, 4-17, B-2 

DISK, 4-18, B-2 

DPY, 4-19, 4-20, B-2 

ERROR, 4-21, B-2 

EXPERT, 4-22, B-2 

INCREMENT, 4-23, 4-24, 
B-2 

ISAVE, 4-25, 4-26, 9-2, 
B-2 

LENGTH, 4-27, B-3 

LMAR, 4-28, B-3 

LOCATION, 4-29, B-3 

LOWER, 4-30, 4-31, B-3 

M33, 4-33, B-3 

M37, 4-34, 4-35, B-3 

MAXLN, 4-36, B-3 

NAME, 4-37, B-3 

NOBAK, 4-38, B-3, 10-13 

NODECIDE, 4-39, B-3 
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Option, (Cont.) 

NODELETE, 4-40, B-3 

NONSEPARATORS, 4-41, B-3 

NONUMBER, 4-42, 4-43, B-3 

NOVICE, 4-44, B-3 

NUMBER, 4-45, B-3 

OLD, 4-46, B-4, 10-13 

OPTION, 4-47, B-4 

PLINES, 4-49, B-4 

PMAR, 4-50, B-4 

READONLY, 4-51, 4-52, B-4 

RMAR, 4-53, B-4 

RUN, 4-54, B-4 

SAVE, 4-55, 9-2, B-4 

SEPARATORS, 4-56, B-4 

SEQUENCE, 4-57, B-4 

START, 4-58, B-4 

STEP, 4-59, B-4 

STRING, 4-60, B-4 

UNSEQUENCE, 4-61, B-5 

UPPER, 4-62, B-5 
Option file, 

SWITCH.INI, 1-12, 4-1, 
4-47 
Option format, 4-1 
70PTI0N NOT POUND, 4-47, 

E-3 
Options, 

/ (Set) command, 5-9 

C command, 5-31 

D command, 5-37 

descriptions of, 4-7 

E command, 5-39 

Edit mode, 

setting, 4-6 

F command, 5-43 

finding status of, 4-7 

G command, 5-47 

giving, 4-5 

I command, 5-57, 5-58 

in indirect file, 4-6 

L command, 5-71 

M command, 5-73 

N command, 5-75 

P command, 5-79 

R command, 5-81 

S command, 5-86 

setting, 4-4, 4-5 

setting SOS, 1-4 

SOS command, 5-2 

T command, 5-93 

W command, 5-101 

with R SOS, 1-13 

X command, 5-105 
%ORDER, E-8 

%OUT OF ORDER, 5-34, 5-38, 
5-69, 5-76, 5-95, 
E-8 



OUTPUT FILE EXISTS, 5-40, 
5-48, 5-102 

Output file specification, 
2-1 



P command, 5-79, 5-80 
P instruction. 

Alter mode, 5-25, A-6 
P option N command, 5-75 
Page, 2-4 

Page mark deletion, 5-37 
Page mark format, 3-1 
Page mark insertion, 5-73 
Page marks, 

killing, 3-13 
Page numbers, 3-1 
Paragraphs, 5-67 
Path, 

directory, 2-2 
Period character, 3-2 
PLINES option, 4-49, B-4 
PMAR option, 4-50, 5-63, 

B-4 
"pointer-name", 4-47 
Position, 2-4 
PPN, 1-12 

PRINT-P command, 5-79, A-15 
Printable option, 

. (Period) , 4-48 

BAK, 4-8 

BIG, 4-11 

C128, 4-13 

C64, 4-12 

CASE, 4-14 

DECIDE, 4-15 

DELETE, 4-17 

DISK, 4-18 

DPy, 4-19 

ERROR, 4-21 

INCREMENT, 4-23 

ISAVE, 4-25 

LENGTH, 4-27 

LMAR, 4-28 

LOCATION, 4-29 

LOWER, 4-30 

M33, 4-33 

M37, 4-34 

MAXLN, 4-36 

NAME, 4-37 

NOBAK, 4-38 

NODECIDE, 4-39 

NODELETE, 4-40 

NONSEPARATORS, 4-41 

PLINES, 4-49 

PMAR, 4-50 

RMAR, 4-53 

RUN, 4-54 
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Printable option, (Cont.) 

SAVE, 4-55 

SEPARATORS, 4-56 

SEQUENCE, 4-57 

START, 4-58 

STEP, 4-59 

STRING, 4-60 

UNSEQUENCE, 4-61 

UPPER, 4-62 
Privileges, 

read/write, 1-3 
Protection code, 2-2 

file, 9-6 



Q, 

DECIDE response, 4-15 

Q instruction. 

Alter mode, 5-25, A-6 
Q option E command, 5-39 
Q option G command, 5-47 
Q option W command, 5-101 
Q response of D option, 

5-86 
Quota, 

disk, 9-9 
.Qxt file extension, 4-38, 
9-3 



R argument JR command, 5-63 
R command, 5-81, 5-82, 

5-83 
R instruction. 

Alter mode, 5-26, A-7 
R response, 

WELL?, 9-11 
R SOS command, 1-13 
Range, 2-4 

Read/write privileges, 1-3 
READONLY option, 4-51, 4-52, 

B-4 
Recalling arguments, 1-11 

SOS command, 1-11 
Recovering from system 

crash, 10-14 
Renumbering lines, 3-14 
Renumbering using other 

than 100, 3-16 
Renumbering your file, 3-15 
REPLACE-R command, 5-81, 

A-15 
Replacement characters, 7-1 

special, 7-6 
Replacement-string, 7-1, 
7-6 



Responses, 

<CTRL/C>, 2-6 

WELL?, 9-9 
Restrictions of, 

. (Move) command, 5-7 

/ (Set) command, 5-9 

= (Give) command, 5-11 

@ (Indirect) command, 5-14 

<LF> command, 5-3 

<ESC> command, 5-5 

A command, 5-17 

BASIC option, 4-10 

C command, 5-34 

C128 option, 4-13 

D command, 5-38 

DECIDE option, 4-16 

DELETE option, 4-17 

DPY option, 4-20 

E command, 5-40 

ERROR Option, 4-21 

F command, 5-45 

G command, 5-48 

H command, 5-51 

I command, 5-58 

INCREMENT option, 4-24 

ISAVE option, 4-26 

J command, 5-61 

JC,JL,JR,JU,JW 
command, 5-63 

K command, 5-69 

L command, 5-71 

LENGTH option, 4-27 

LMAR option, 4-28 

LOWER option, 4-32 

M command, 5-73 

M33 option, 4-33 

M37 option, 4-35 

MAXLN option, 4-36 

N command, 5-76 

NAME option, 4-37 

NOBAK option, 4-38 

NONUMBER option, 4-43 

NUMBER option, 4-45 

OLD option, 4-46 

OPTION option, 4-47 

P command, 5-79 

PMAR option, 4-50 

READONLY option, 4-52 

RMAR option, 4-53 

S command, 5-89 

SAVE option, 4-55 

SOS command, 5-2 

START option, 4-58 

STEP option, 4-59 

T command, 5-94 

UNSEQUENCE option, 4-61 

VL,VU,VV 

command, 5-99 

W command, 5-102 
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<RET> instruction. 

Alter mode, 5-19, A-8 
RMAR option, 4-53, 5-63, 

B-4 
RUN option, 4-54, 5-47, 

5-48, B-4 



S command, 5-85, 5-86, 

5-87, 5-88, 5-89, 
5-90, 5-91, 7-5, 
7-7 
S command line contents, 

examples, 8-5, 8-6, 8-7, 
8-8 
S instruction. 

Alter mode, 5-27, A-7 
S option E command, 5-39 
S option G command, 5-47 
S option W command, 5-101 
SAVE option, 4-55, 9-2, B-4 
Save-the-World command, 

5-101, 9-1 
Saving files with line 

numbers, 9-3 
Saving files without line 

numbers, 9-4 
Saving with no backup file, 

9-5 
Saving your file, 9-3 
%SEARCH FAILS, 5-45, 5-89, 

E-8 
%SEARCH STRING COMPLEX, 

5-89, E-8 
%SEARCH STRING TOO COMPLEX, 

5-46 
SEPARATORS option, 4-56, 

B-4 
SEQUENCE option, 4-57, B-4 
Settable option, 
BAK, 4-8 
BASIC, 4-9 
C128, 4-13 
C64, 4-12 
DECIDE, 4-15 
DELETE, 4-17 
DPY, 4-19 
EXPERT, 4-22 
INCREMENT, 4-23 
ISAVE, 4-25 
LENGTH, 4-27 
LMAR, 4-28 
LOWER, 4-30 
M33, 4-33 
M37, 4-34 
MAXLN, 4-36 



Settable option, (Cont.) 
NAME, 4-37 
NOBAK, 4-38 
NODECIDE, 4-39 
NODELETE, 4-40 
NONSEPARATORS , 4-41 
NONUMBER, 4-42 
NOVICE, 4-44 
NUMBER, 4-45 
OLD, 4-46 
OPTION, 4-47 
PLINES, 4-49 
PMAR, 4-50 
READONLY, 4-51 
RMAR, 4-53 
RUN, 4-54 
SAVE, 4-55 
SEPARATORS, 4-56 
SEQUENCE, 4-57 
START, 4-58 
STEP, 4-59 
UNSEQUENCE, 4-61 
UPPER, 4-62 
Setting options, 1-4, 4-4, 

4-5 
Setting options. 

Edit mode, 4-6 
SOS, 

and terminal setting, 

6-1 
backup files, 9-6, 9-7, 

9-8 
character table, C-1, 

C-2 
command arguments, 5-2 
command characteristics, 

5-2 
COMMAND DESCRIPTIONS, 

5-1 
command examples, 5-2 
command format, 1-4, 

5-2 
command function, 5-2 
command hints, 5-2 
command instructions, 

5-2 
command level, 2-2 
command level format, 

2-4 
command operation, 5-2 
command options, 5-2 
command recalling 

arguments, 1-11 
command restrictions, 

5-2 
command special cases, 

5-2 
control modes, 1-6 
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SOS, (Cont.) 

default line number, 
4-58, 4-59 

defaults, 6-1 

error messages, E-1 

file backup, 9-1 

files and buffers, 10-1 

input level, 2-2 

input line format, 2-3 

page mark format, 3-1 

program, 

setting options, 1-4 

.TEM file, 10-2 

.TMP file, 10-3 

using options, 4-1 
<SP>, 

DECIDE response, 4-15 
<SP> instruction. 

Alter mode, 5-19, A-8 
<SP> response of D option, 

5-86 
Special cases, 

SOS command, 5-2 

C command, 5-31 

D command, 5-37 

F command, 5-44 

M command, 5-73 

N command, 5-75 

R command, 5-82 

S command, 5-87 

T command, 5-93 

X command, 5-106 
Special character diagram, 

7-8, 7-9, 7-10 
Special character meaning, 

6-8 
Special characters, 6-1, 

7-1 
Special characters, 

typing, 6-7 
Special matching characters, 

5-88, 7-2 
Special mode C128, 7-2 
Special replacement 

characters, 5-88, 7-6 
Specification, 

character match, 7-3 

file, 1-2 

match character, 7-4 
Specification examples, 

line contents, 8-2, 8-3, 
8-4 
Specifications, 

file, 4-37, 4-54 

full file, 2-1 

line contents, 4-42, 4-60, 
8-1 
%SRF, E-8 



Standard file extensions. 

Appendix D 
START option, 4-58, B-4 
Start-here string, 8-2 
Starting input mode, 1-6, 

1-7 
Status of options, 

finding, 4-7 
%STC, E-8 

STEP option, 4-59, B-4 
%STL, E-8 

Stopping a command, 2-5 
String, 

finish-here, 8-2 

start-here, 8-2 
STRING option, 4-60, B-4 
%STRING TOO LONG, 5-45, 

5-87, 5-89, E-8 
SUBSTITUTE-S command, 4-60, 

5-85, 7-1, 8-5, A-15 
SWITCH.INI, 4-2, 4-3 
SWITCH.INI file, 4-52 

line format, 4-2 
SWITCH.INI option file, 

1-12, 4-1, 4-47 
/switches, 2-1 
Symbols, 

line/page number, A-1 
PSYNTAX ERROR DEFAULT 

OPTIONS, E-4 
7SYNTAX ERROR OPTION FILE, 

4-47, E-4 
System crash, 

recovering from, 10-14 



T command, 5-93, 5-94, 

5-95, 5-96, 5-97 

T response, 

WELL?, 9-10 

<TAB>, 2-3 

<TAB> instruction. 

Alter mode, 5-20, A-8 

.TEM file, 10-1, 10-2, 
10-14 

Temporary files, 10-1, 
10-3, 10-14 

Terminal , 

LA36, 6-1, 6-6 
upper/lowercase, 6-6 
uppercase-only, 6-2 
VT05, 6-1, 6-2, 6-3 
VT06, 6-1 

VT50, 6-1, 6-2, 6-4 
VT52, 6-1, 6-6 

Terminal characteristics, 
2-1 
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Terminal setting in 

SOS, 6-1 
%TEXT INSERTED END OF FILE, 

5-94, E-9 
.TMP file, 10-1, 10-3, 

10-14 
%TMS, E-9 
%T00 MANY STRINGS, 5-45, 

5-87, E-9 
TRANSFER-T command, 5-93, 

A-16 
Typing errors, 

correcting, 2-5 
Typing lowercase, 6-3, 6-7 
Typing special characters, 

6-7 
Typing uppercase, 6-2, 6-6 



U argument JU command, 5-63 
U argument V command, 5-99 
UNSEQUENCE option, 4-61, 

5-40, 5-48, B-5 
Up-arrow character, 3-3 
UPPER option, 4-62, 6-4, 

B-5 
Upper/lowercase terminal, 

6-6 
Uppercase, 

typing, 6-2, 6-6 
Uppercase characters, 6-1 
Uppercase-only terminal, 

6-2 
Using <CTRL/C>, 2-6 
Using <CTRL/G>, 2-5 
Using indirect file, 2-8 
Using multipage files, 3-1 
Using options with SOS, 1-4 
Using SOS options, 4-1 
Using temporary files, 10-3 



V argument V command, 5-99 

V command, 5-99, 5-100 

V instruction. 

Alter mode, 5-28 
INVERT-V command, 5-99, 

A-16 
VL command, A-16 
VT05 terminal, 6-1, 6-2, 

6-3 
VT06 terminal, 6-1 



VT50 terminal, 6-1, 6-2, 

6-4 
VT52 terminal, 6-1, 6-6 
VU command, A-16 
W command, A-16 



W argument JW command, 5-63 
W command, 5-101, 5-102, 

5-103, 5-104 
your files after, 10-9 
W instruction. 

Alter mode, 5-28, A-7 
W response, 

WELL?, 9-11 
%WAR, E-9 
%WARNING COPY ASSUMED, 5-94, 

E-9 
WB command, 5-101, 9-5 
WD command, 5-101, 9-6 
WELL?, 9-9 

WELL? G response, 9-10 
WELL? R response, 9-11 
WELL? T response, 9-10 
WELL? W response, 9-11 
WORLD-W command, 4-55, 4-61, 

5-101, 9-1, A-17 
WQ command, 5-101, 9-6 
Wrap around, 3-16 
%WRAP AROUND, 5-34, 5-76, 

E-9 
WS command, 4-61, 5-101, 

9-4 



X command, 5-105, 5-106, 

5-107 
X instruction. 

Alter mode, 5-29, A-7 
EXTEND-X command, 5-105, 
A-17 



YES?, 2-6, 9-11, A-1 



,Zxt file extension, 4-46, 
10-13 
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